home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Gold Collection / Software Vault - The Gold Collection (American Databankers) (1993).ISO / cdr31 / mta_vf36.zip / MTADOCEN.DOC < prev    next >
Text File  |  1993-04-04  |  442KB  |  8,422 lines
  1. ╔══════════════════════════════                 ┌─────────────────┐
  2. ║ MTA       Make Them Anything                  │    D.I.S.P.     │────┐
  3. ║           Convert Compressed                  │                 │░░░░│
  4. ╟──────────────────────────────                 │                 │░░░░│
  5. ║ (c) 1993  Robert W.van Hoeven                 │ Dutch           │░░░░│
  6. ╟──────────────────────────────                 │   Independent   │░░░░│
  7. ║ Release : 15.36                               │     ShareWare   │░░░░│
  8. ║ Rel.Date: March 13th, 1993                    │       Programmer│░░░░│
  9. ╠══════════════════════════════                 └─────────────────┘░░░░│
  10. ║                                               |    │░░░░░░░░░░░░░░░░░│
  11. ║ │ MTA.EXE / MTM.EXE                           |    └─────────────────┘
  12. ║ │ MTL.EXE / MTZ.EXE                           |       ┌─────┐        |
  13. ║ │ MTA.CTL / MTA.CHx                           |       │░░░░░│        |
  14. ║ │                                             |       └──┬──┘        |
  15. ║ │ MTAOVR.EXE / MTAOVR.OVR (*)                 |     ┌────┴────┐      |
  16. ║ │                                             ------││││││ ═══│-------
  17. ║ │ Lines starting with '│' are                       └─────────┘
  18. ║ │ changes to release 15.35
  19. ║ │
  20. ║ │
  21. ╠═══════════════════════════════
  22. ║ Address: Robert W. van Hoeven
  23. ║          PO. Box 131
  24. ║          1170 AC  Badhoevedorp
  25. ║          Nederland / Holland
  26. ╚═══════════════════════════════
  27.  
  28. ╔═══════════════════════ (*) OVERLAY FILES ════════════════════════════╗
  29. ║ MTAOVR.EXE and MTAOVR.OVR are files that make the overlayed version  ║
  30. ║ of MTA. These files are available in a separate package which can be ║
  31. ║ found under the name MTAOVvvv.eee (where vvv has the same number as  ║
  32. ║ the last 3 digits of this archive (e.g. F10, F11, F35) and eee is    ║
  33. ║ the extension.                                                       ║
  34. ╚══════════════════════════════════════════════════════════════════════╝
  35.  
  36. ╔══════════════════════════════════════════════════════════════════════╗
  37. ║ READ THE MTA.NEW DOCUMENTATION, THERE ARE SOME CHANGES IN PARAMETERS ║
  38. ║ AND OPTIONS !                                                        ║
  39. ╚══════════════════════════════════════════════════════════════════════╝
  40.  
  41.  ┌───────┬─────────────────────────────────────────────────────────────┐
  42.  │   0   │ Table of contents                                           │
  43.  └───────┴─────────────────────────────────────────────────────────────┘
  44.  
  45.  1 ----    General information
  46.   1.1      Copyrights and License Agreement
  47.   1.2      Newer versions and contacting the author
  48.  
  49.  2 ----    Package description and requirements
  50.   2.1      Preface
  51.   2.2      Requirements
  52.   2.3      Included files
  53.   2.4      History
  54.  
  55.  3 ----    Installation description
  56.   3.1      Installation
  57.    3.1.1   Installation of the software
  58.    3.1.2   The overlay mechanism
  59.   3.2      Archivers
  60.    3.2.1   General remarks and suggestions on archivers
  61.    3.2.2   Remarks on ARC
  62.    3.2.3   Remarks on PAK
  63.    3.2.4   Remarks on ZIP
  64.    3.2.5   Remarks on PKPAK/PKUNPAK
  65.    3.2.6   Remarks on DWC
  66.    3.2.7   Remarks on ZOO
  67.    3.2.8   Remarks on LHarc
  68.    3.2.9   Remarks on LArc
  69.    3.2.10  Remarks on MD
  70.    3.2.11  Remarks on ARJ
  71.    3.2.12  Remarks on HYPER
  72.    3.2.13  Remarks on PKLITE
  73.    3.2.14  Remarks on GIFLITE
  74.    3.2.15  Remarks on JPEG
  75.    3.2.16  Remarks on GIFTEST
  76.    3.2.17  Remarks on SQZ
  77.   3.3      MTA.CTL
  78.    3.3.1   Basic statements
  79.    3.3.2   Statements that define the environment that MTA uses (paths)
  80.    3.3.3   Statements that define the logging
  81.    3.3.4   Statements that define the selection of files
  82.    3.3.5   Statements that define the resulting files
  83.    3.3.6   Your own (new) compressor
  84.    3.3.7   Statements that define the various exits (hooks) in MTA
  85.    3.3.8   Statements that are useful to Bulletin Board Systems/SysOp's
  86.    3.3.9   Special statements
  87.    3.3.10  Statements available when using a registered version
  88.   3.4      Diskette option
  89.   3.5      KeyBoard control
  90.   3.6      Running multiple copies of MTA at the same time
  91.   3.7      Compression of single executable files (PKLITE)
  92.   3.8      The MTA tag-window
  93.   3.9      MTA and unattended operations
  94.   3.10     TICK-files and related material
  95.   3.11     FES, yet another TICK-clone ?
  96.   3.12     Special ARC considerations
  97.   3.13     Using newer versions of archivers
  98.   3.14     Lo-tek functions, calling MTA as shell of MTA
  99.   3.15     TEC files
  100.  
  101.  4 ----    Run-time information
  102.   4.1      Command-line parameters
  103.    4.1.1   Command-line parameters that stand on their own
  104.    4.1.2   Command-line parameters that overrule/toggle/disable MTA.CTL
  105.    4.1.3   Command-line parameters with a special usage
  106.   4.2      Aborting MTA
  107.   4.3      LOG file
  108.   4.4      Errors
  109.  
  110.  5 ----    Version information and credits
  111.   5.1      The BETA-team
  112.   5.2      Credits
  113.   5.3      Version history
  114.   5.4      Copyright, Trademarks
  115.  
  116.  ┌───────┬─────────────────────────────────────────────────────────────┐
  117.  │   1   │ General information                                         │
  118.  └───────┴─────────────────────────────────────────────────────────────┘
  119.  
  120.  1.1 Copyrights and License Agreement
  121.  ────────────────────────────────────
  122.  
  123.  - Users of the MTA-package must accept this disclaimer of warranty:
  124.  
  125.  - The  MTA-package  is  supplied  as  is.   The  author  disclaims  all
  126.    warranties, expressed or implied, including, without limitation,  the
  127.    warranties of merchantability  and of fitness  for any purpose.   The
  128.    author assumes  no liability  for damages,  direct or  consequential,
  129.    which may result from the use of the MTA-package;
  130.  
  131.  - The  MTA-package  is  a  "shareware  program"  and is provided at  no
  132.    charge to the user for evaluation.   Feel free to share it with  your
  133.    friends,  but  please  do  not  give  it  away  altered or as part of
  134.    another  system.   The  essence  of  "user-supported"  software is to
  135.    provide personal  computer users  with quality  software without high
  136.    prices, and yet to provide  incentive for programmers to continue  to
  137.    develop new products.
  138.  
  139.  - If  you find  this program  useful and  find that  you are  using and
  140.    continue the  use of  the MTA-package  after a  30 days trial period,
  141.    you must register the MTA-package as described below;
  142.  
  143.  - Non-commercial can get a license for the usage up to this release  of
  144.    the MTA-package for  a small amount  of money. Look  into the details
  145.    in  REGISTER.MTA.  Previous  registered  users  will  receive  a  big
  146.    reduction to upgrade to the  newer versions. These users should  look
  147.    into the details in UPGRADE.MTA.   For Non-commercial users there  is
  148.    a POSSIBILITY to submit to one of the special contracts as  explained
  149.    in the file REGISTER.MTA.
  150.  
  151.  - Commercial usage of  MTA will cost somewhat  more. Also, a so  called
  152.    'closed' Bulletin  Board System  (a system  where the  user must  pay
  153.    direct to the  SysOp to get  full access) is  has to pay  more than a
  154.    Non-commercial  user.  Both  types  of  users  should  look  into the
  155.    details in REGISTER.MTA;
  156.  
  157.  - The registration of the MTA-package will license ONE copy for use  on
  158.    any computer at any  one time, as long  as the usage confirms  to the
  159.    type of registration you have done (so NON-commercial usage when  you
  160.    have a non-commercial license);
  161.  
  162.  - Anyone  distributing  the  MTA-package  for any kind of remuneration
  163.    must  first   contact  the   Author   at   the  address   above   for
  164.    authorization.
  165.  
  166.  - You are  encouraged  to  pass a copy   of the MTA-package  along   to
  167.    your friends  for  evaluation.   Please  encourage  them to  register
  168.    their copy if they find that they can use it;
  169.  
  170.  - Support  on  MTA,  when  used  in  a  non-commercial environment,  is
  171.    available  by  means  of  written  letters  or by entering the inter-
  172.    national echomail area DISP;
  173.  
  174.  - Problems and suggestions can be entered in the FidoNet <tm>  Echomail
  175.    conference <tm> called DISP (international). Entering this echo  does
  176.    not  exclude  you  of  the  duty  to register the MTA-package, though
  177.    users who evaluate the product can enter the echo for questions;
  178.  
  179.  - The  MTA-package, all  programs, the  documentation and support-files
  180.    is  copyrighted  1990,93  by  Robert  W.  van  Hoeven,  PO.  Box 131,
  181.    Badhoevedorp 1170AC, Holland. All  rights are reserved. You  may copy
  182.    this  package  for  backup  purposes.  Also  you  may  copy and share
  183.    unmodified copies of the whole package, providing that the  copyright
  184.    notice    is    reproduced    and    included    on    all    copies.
  185.    Excluded from this statement  are the support-files written  by other
  186.    authors.  Please  refer  to  the  documentation of these programs for
  187.    copyrights and license agreements;
  188.  
  189.  - It  is  forbidden  to  modify,  adapt,  translate, reverse  engineer,
  190.    decompile  and/or  disassemble  the  software  in  the   MTA-package.
  191.    Patching the medium at  places that carry the  software is seen as  a
  192.    program change and is also forbidden. It is forbidden to create a  so
  193.    called 'bypass' to skip the original introduction screens and  delay.
  194.    Also it is forbidden  to use such a  'bypass' unless supplied by  the
  195.    author (Robert W. van Hoeven) himself;
  196.  
  197.  - Performing  any  of  the  illegal  actions as stated in the previous
  198.    lines,  is  a  theft  and  no  fair  play  to  the  author  and, more
  199.    important, to the registered users;
  200.  
  201.  - Bulletin Board  Systems that distribute  the MTA package  can convert
  202.    the WHOLE package  to any archive-system  they like but  all original
  203.    files must  be included  in the  new archive.  The MTA-package on the
  204.    Bulletin Board  can contain  at the  most 2  extra files. These files
  205.    can only be  a commercial for  that Bulletin Board  and/or validation
  206.    data that is presented  as a service to  all users and shall  have no
  207.    other functions;
  208.  
  209.  - After  the normal  trial period  of 30  days, you  must register  the
  210.    soft- ware (see REGISTER.MTA) or you must remove it from your PC;
  211.  
  212.  - Comments,  suggestions  and  bug  reports  are  welcome  and will  be
  213.    answered as soon I have the time  to do so. You can send me  a letter
  214.    of leave  a NetMail  <tm> message  named to  Rob Van.hoeven (mind the
  215.    point)  on  node  2:512/100  (RA  Support, Monster, Holland, SysOp is
  216.    Reinier de Groot).  When you want to send me normal mail, address  it
  217.    to:   Robert  W.  van  Hoeven,  PO.  Box  131,  1171 AC Badhoevedorp,
  218.    Holland;  Also  you  can  enter  messages  in  the  FidoNet <tm> DISP
  219.    Echomail <tm> area;
  220.  
  221.  
  222.  1.2 Newer versions and contacting the author
  223.  ───────────────────────────────────────────────────────────────────────
  224.  The newest version of  MTA is always available  at the DISP-HQ on  node
  225.  2:512/100.  MTA  is  also  distributed  thru  a  number of DISP support
  226.  nodes.  There are three ways of obtaining newer versions of MTA:
  227.  
  228.  
  229.  - Logging on at DISP-HQ or a support node
  230.    Look into the file SUPPORT.MTA for a full list of support nodes;
  231.  
  232.  - Logging on to a SDS node
  233.    MTA is distributed thru SDS/SDN, but only big minors (x.10, x.20  and
  234.    so on) and majors (14.01, 15.01  and so on) are submitted to  the SDS
  235.    distribution point in Holland;
  236.  
  237.  - Logging on to your own BBS;
  238.    Chances  are,  that  you  will  find  an older version (international
  239.    users) because it will take some time for the new version to  'bleed'
  240.    thru the net;
  241.  
  242.  - Update service;
  243.    You can enter a special update service (read REGISTER.MTA).
  244.  
  245.  
  246.  If you think you have found problems in MTA, or in any other case,  you
  247.  wish to contact the author, you can send me:
  248.  
  249.  - A letter to the address you can find in the header of this file;
  250.  
  251.  -  A  NetMail  <tm>  message  to  Rob Van.hoeven (please mind the point
  252.    between Van and Hoeven) at 2:512/100 or (better) 2:512/100.5;
  253.  
  254.  - A Message in the FidoNet <tm> DISP echomail <tm> area;
  255.  
  256.  ┌───────┬─────────────────────────────────────────────────────────────┐
  257.  │   2   │ Package description and requirements                        │
  258.  └───────┴─────────────────────────────────────────────────────────────┘
  259.  
  260.  2.1 Preface
  261.  ───────────────────────────────────────────────────────────────────────
  262.  MTA is a program that can  be helpful with the job to  convert archives
  263.  (compressed files) from one archive-system (ZIP, ARJ, LZH and such  are
  264.  called archive-systems) to another one.
  265.  
  266.  The   conversion   from   archive-systems    is   something   that   is
  267.  done frequently  on  BBS  systems.  Different  users  do  uploads   for
  268.  files  created  in   various   archive-systems.   The  SysOp    (System
  269.  Operator   of a  BBS) will  make these   files available  in only   one
  270.  system so all  users who  download   one  or  more  files,  only   need
  271.  one archive program to decompress the files.
  272.  
  273.  When  a   normal  user   visits  various   BBS's  that   all have their
  274.  own archive system,   she/he will   also get   a mixture   of different
  275.  files, created in different archive-systems. In this case MTA can  also
  276.  help.
  277.  
  278.  There a tons of features available in MTA. Some of them will only  have
  279.  a meaning for a SysOp, some of  them only for the normal user and  many
  280.  of them for  both. Users can  automatically remove files  from archives
  281.  (many BBS's add  headers and/or files  to the archive  as advertisement
  282.  for the BBS),  SysOp's can add  them, both can  scan for viri  (in many
  283.  different  ways).  There  are  options  to  convert  a  single  file, a
  284.  complete directory (with  or without sub-directories),  complete drives
  285.  and a  special feature  to convert  all files  on a  diskettes from one
  286.  system to another (while the user  won't have to worry that the  target
  287.  files will not fit on the diskette). The list can go on for hours.
  288.  
  289.  The MAJOR   benefit of   MTA is,   that it   treats ANY   of the   most
  290.  known  archivers  with   the  same   service.  Other   programs may  be
  291.  smaller  but only  treat a certain archive-system  for  the full  100%.
  292.  MTA  is  made   in  a   way   that   YOU   can   decide   what   output
  293.  (archive-system)  should  be  created  without   having  to  search for
  294.  better programs  when  you  swap from  one system  to  another. Another
  295.  benefit of  MTA   is the  up-to-date status  of the   program. For more
  296.  than 3  years   now, I  have   managed to  update MTA  at the same time
  297.  (and  sometimes  earlier)  you  got  hold   of  a  new  version of your
  298.  archive-program.  And even when you are  not served within the  minute,
  299.  you  can  always  use  the  special  routines  in MTA  that implement a
  300.  'user-type'  of  archive   program  (based  on  the  extension   of the
  301.  archives).
  302.  
  303.  MTA's documentation  is NOT  easy. It  is a  large text.  There are  so
  304.  many options that can be   useful for you. The   best way to start   is
  305.  to read  everything one  (without   the description  of   the options),
  306.  then  take a ASCII-editor, import chapter   3 and start  to create  the
  307.  configuration  file,  line  by  line,  option  by  option.  If you have
  308.  completed the   setup, you nearly  don't have   to look at  it  anymore
  309.  for a long  time, so take your time.
  310.  
  311.  
  312.  2.2 Requirements
  313.  ───────────────────────────────────────────────────────────────────────
  314.  MTA requires:      - PC XT/AT/386/486 (or more)
  315.                     - At least 400K free memory but it depends on the
  316.                       archiver(s) you use (NON OVERLAYED VERSION);
  317.                     - At least 200K free memory but it depends on the
  318.                       archiver(s) you use (OVERLAYED VERSION);
  319.                     - DOS 3.xx and higher;
  320.                       (tested with 4Dos 4.0, should work with lower
  321.                       versions);
  322.                     - DOS 2.xx ONLY when registered. In this case, a
  323.                       customized version will be created;
  324.                     - HDU optional
  325.                     - Mouse optional
  326.                     - One or more virus-scanners (optional)
  327.                     - The original (de)compression programs. MTA does
  328.                       NOT contain the compression/decompression
  329.                       routines;
  330.                     - The  original  GIF  conversion  programs that are
  331.                       supported by MTA;
  332.  
  333.  
  334.  2.3 Included files
  335.  ───────────────────────────────────────────────────────────────────────
  336.  The package includes : MTA.EXE         The main program
  337.                         MTA.CH1         The chained tag-menu module
  338.                         MTA.CH2         The chained help-menu module
  339.                         MTM.EXE         The maintenance program
  340.                         MTL.EXE         The list program
  341.                         MTA_DIR.EXE     The directory utility
  342.                         MTA_CRC.EXE     The VALIDATE caller
  343.                         MTA__BAT.EXE    A SFX with examples of batches
  344.                         MTA__UTL.EXE    A SFX with additional utilities
  345.  
  346.  Besides this normal and complete package, there is an additional  file,
  347.  containing MTAOVR.EXE and MTA.OVR. These are the files that are  needed
  348.  to run MTA in overlayed mode.
  349.  
  350.  
  351.  
  352.  2.4 History
  353.  ───────────────────────────────────────────────────────────────────────
  354.  MTA is  now 3  years old.  It started  with version  4.01 (first public
  355.  release). Releases 1, 2  and 3 were called  MTZ and could only  convert
  356.  ZIP-files. With  release 13,  MTA changed  from freeware  to shareware.
  357.  With release  14, MTA  added some  extra options  for BBS's  and became
  358.  able to output some of  the text to a modem  (so MTA could be run  as a
  359.  shell under the BBS or a protocol-driver). With release 15, a new  type
  360.  of compressed files is supported.  These are GIF files. Release  15 can
  361.  support  the  conversion  of  GIF  files.  Also,  within  release 15, a
  362.  MS/Windows version of MTA will  be released AND (finally) the  setup of
  363.  the configuration  file will  change from  a ASCII-file  to a  windowed
  364.  (full-screen) setup program  (not in 15.01,  15.01 is a  forced release
  365.  because of the upcoming ZIP 2.xx).
  366.  
  367.  I will try to  keep MTA  as  up-to-date as possible. Every  few  months
  368.  or so, new  versions  of  archive programs   hit the  market. Some   of
  369.  these versions  contain  new   algorithms  and  also  contain   changes
  370.  in the  internal structure.  Up to  now, I   was able  to release a new
  371.  version of MTA only   a few  days  after  the final   release of   such
  372.  versions   (and  sometimes  earlier,  based   on  the   beta-versions).
  373.  Needless to say  that it is a hell of a job to keep informed about  all
  374.  the changed.
  375.  
  376.  ┌───────┬─────────────────────────────────────────────────────────────┐
  377.  │   3   │ Installation description                                    │
  378.  └───────┴─────────────────────────────────────────────────────────────┘
  379.  
  380.  3.1 Installation
  381.  ───────────────────────────────────────────────────────────────────────
  382.  MTA is  not an  easy program  to install.  There are  numerous features
  383.  that can be used.  Also, there are no  specific guidelines for a  quick
  384.  install of the program,  but in the next  chapters I will try  to guide
  385.  you thru the installation in a structured way. Both  new  and  advanced
  386.  users should also take a look at  any  included *.TEC file. These files
  387.  (if present) will give a wider description  of  a  specific topic which
  388.  has caused some questions in the past.
  389.  
  390.  
  391.  3.1.1 Installation of the software
  392.  ───────────────────────────────────────────────────────────────────────
  393.  The first step is  the installation of the  (program) files. This is  a
  394.  very easy step if  you observe all the  following rules. The next steps
  395.  are described with a hard-disk system in mind:
  396.  
  397.  - Decide which directory you want to use. MTA can find its own  support
  398.    files in three possible ways (in the following order):
  399.  
  400.    - In the current directory;
  401.    - The directory containing MTA.EXE (DOS 3.xx and higher only) or any
  402.      other program name if you have renamed  MTA.EXE to something else.
  403.      The same goes for the overlay version;
  404.    - The DOS PATH (DOS 2.xx and higher);
  405.  
  406.    Either use an existing directory or create a new directory that  will
  407.    be used for the  installation of MTA (in  the second case, add  it to
  408.    the DOS PATH,  so the call  to MTA.EXE can  be done from  anywhere on
  409.    the disk);
  410.  
  411.  - Place MTA.EXE, MTA.CH1, MTA.CH2, MTL.EXE, MTM.EXE and MTZ.EXE in  the
  412.    selected directory.  If you  don't want  to use  MTL, MTM and/or MTZ,
  413.    you  can  always   remove  them  later.   MTA.CH1  and  MTA.CH2   are
  414.    (sometimes) needed  by MTA.  MTA.CH1 contains  the interactive  pick-
  415.    list to select files  from a large list,  MTA.CH2 is called when  you
  416.    want help information about  the command-line options. When  you have
  417.    obtained the overlayed version of MTA, you must also copy  MTAOVR.EXE
  418.    and MTAOVR.OVR to the selected directory. All programs CAN be renamed
  419.    to anything you like (e.g.  delete the non-overlayed MTA.EXE and  re-
  420.    name  the  overlayed  MTAOVR.EXE  to  MTA.EXE) but the files MTA.CH1,
  421.    MTA.CH2 can NOT be renamed. Also when you rename the overlay  version
  422.    (MTAOVR.EXE), you must give the  filename-part (not the extension) of
  423.    the overlay file (MTAOVR.OVR) the SAME name (so  rename MTAOVR.EXE to
  424.    BLURB.EXE, in that case, rename MTAOVR.OVR to BLURB.OVR);
  425.  
  426.  - Copy the  included example of  MTA.CTL to the  same directory as  the
  427.    MTA program files. This example file must be changed later on to  you
  428.    own environment and needs. For now, leave it unchanged;
  429.  
  430.  - MTA can  also look for  an environment variable  called MTA. You  can
  431.    add a line  in AUTOEXEC.BAT with  the value 'SET  MTA=[path]' (do not
  432.    code the  quotes and  replace [path]  with the  name of the directory
  433.    where MTA.EXE/CH1/CH2/OVR/CTL are;
  434.  
  435.  - NEVER  use compression  programs like  PKLITE, SHRINK  or DIET on the
  436.    executable files inside  the MTA package.  They must stay  unaltered.
  437.    The programs that are called within MTA (archivers, exits) can,  from
  438.    MTA's point of view, be compressed with these programs. If you insist
  439.    on using the least possible space, you CAN compress  the MTA.CH1/CH2,
  440.    MTL.EXE, MTM.EXE and MTZ.EXE files with PKLITE  or any other program
  441.    that you like;
  442.  
  443.  - Be sure to have the DOS program  SUBST.COM/EXE inside your DOS path.
  444.    This program comes with your release  of  DOS and without them,  MTA
  445.    can do  less of the  conversion  than when  you  have them available.
  446.    As you will see  later, you  need  special  options to set to a value
  447.    to let  MTA make use of this program (so you can still have  them  on
  448.    the drive without MTA using them). Unless  you  have  a special setup
  449.    networks and such), you can rest  assure that you can  use  the SUBST
  450.    program along with MTA, unless you use specialized software that will
  451.    not match with SUBST usage;
  452.  
  453.  - When  installing the  MTA files,  also take  some time  to see  which
  454.    archive programs  you have  where (write  them down,  because you can
  455.    use this  info when  you create  MTA.CTL). Also  take a  look at  the
  456.    versions  you  run  of  these  programs.   The  next chapters will go
  457.    into  specific  details  for  every  supported  archiver.  In case of
  458.    difficulty  or  just  to  stay  up-to-date,  you should try to obtain
  459.    the highest version that is mentioned in the documentation;
  460.  
  461.  - When using the overlayed  version  of  MTA, you  should read the next
  462.    paragraph for more details on how to setup the overlay environment;
  463.  
  464.  
  465.  3.1.2 The overlay mechanism
  466.  ────────────────────────────────────────────────────────────────────────
  467.  There is also an overlay version of MTA. This means  that only part  of
  468.  the code will be active and available in conventional memory (the  part
  469.  of  memory  up  to  640K)  and  the  remaining parts of the code can be
  470.  loaded into  memory when  a certain  part is  needed. Overlays are only
  471.  useful when a program will not  have to access all parts of  the coding
  472.  in  a  short  time.  The  more  coding  is not needed concurrently, the
  473.  bigger the overlay and the smaller the part of conventional memory  the
  474.  program needs.
  475.  
  476.  When a program  is written, the  author will always  try to search  for
  477.  the  best  result  on  a  large  number of implementations, but not all
  478.  situations can be dealt with. Because of these special situations,  MTA
  479.  includes a number of options to make the overlay mechanism as  flexible
  480.  as possible. To change the  overlay mechanism means that you  must know
  481.  how it works by default. When MTA is loaded, it will try to  initialize
  482.  the overlay manager first. This is done in the following manner:
  483.  
  484.  - The program  will search for  the overlay-file. The  location it will
  485.    search is the location where the EXE-file is found. The name must  be
  486.    the same as  the filename-part (without  extension) of the  EXE-file,
  487.    so when you rename MTAOVR.EXE to MTA.EXE, you must  also  rename  the
  488.    MTAOVR.OVR file to TA.OVR. This mechanism works for all  DOS releases
  489.    from version 3.0 and higher. Lower versions of  DOS (1.x and 2.x) can
  490.    not work in  this manner and  you need to  set the location  and name
  491.    overlay-file with help of an environment variable (see later);
  492.  
  493.  - If  the overlay-file  is found,  the program  will initialize  it and
  494.    will examine the memory.  The overlay-manager need some  conventional
  495.    memory  and  it  can  store  the  remaining  part of the overlay (the
  496.    not-active part) in  expanded memory (EMS)  if that is  available and
  497.    contains enough  free memory.  The size  of the  part of conventional
  498.    memory is variable (though it can not  be too small) and is set to  a
  499.    good average  (by default).  The size  of the  part of  EMS memory is
  500.    fixed  for  a  given  release  of  the program. The more conventional
  501.    memory  that  is  assigned  to  the  overlay  buffer,  the better the
  502.    performance  of  the  program  but  the less memory (conventional) is
  503.    available. If the  overlay part can  not be loaded  into EMS (because
  504.    it isn't there or there isn't enough free memory in EMS), it will  be
  505.    left  on  disk  and  parts  of  the  coding  must be loaded from disk
  506.    (slower!) when they are needed;
  507.  
  508.  - If  the overlay-managers  fails to  install the  overlay, the program
  509.    will abort. In general, the failing will be the result of:
  510.  
  511.    - The OVR-file (the overlay) could not be found;
  512.  
  513.    - Not enough conventional memory available to load the overlay;
  514.  
  515.    - Invalid (old) EMS drivers;
  516.  
  517.    - I/O errors on the overlay-file
  518.  
  519.    - Conflicts  between  other  programs  that  use EMS or  conventional
  520.      memory (TSR's, device drivers);
  521.  
  522.  In general, when you do  nothing about the overlay-manager and  you run
  523.  under DOS 3.xx  or higher, you  will have a  solid running program.  If
  524.  you have problems (see above) or  you want to optimize the program  for
  525.  better  thruput,  you  can  (must)  alter the overlay management. These
  526.  changes must be  made with help  of environment variables  (see the DOS
  527.  SET command). Many people asked why you can't put these changes  inside
  528.  the control-file.  That is  not possible,  because the  parsing of  the
  529.  control-file itself is  an overlayed part  of the coding.  You need the
  530.  overlay before you can  access the control file.  That is why you  must
  531.  make use of environment variables. The following environment  variables
  532.  are tested for:
  533.  
  534.  MTAOVROL : This environment variable can  be used to point to the  name
  535.             and/or location of the overlay-file.  You can use it in  two
  536.             ways:
  537.  
  538.             (1) SET MTAOVROL=F:\RAMDRIVE\
  539.             (2) SET MTAOVROL=C:\BBS\PRG\MTA.OVR
  540.  
  541.             In  the  first  case  (1)  you  point  to the directory that
  542.             contains the overlay-file. The  name of the overlay-file  is
  543.             generated from  the program-name  (minus the  extension), so
  544.             when  you  have  MYMTA.EXE,  you  must put MYMTA.OVR in this
  545.             directory  first.  The  directory-name  MUST  end with a '\'
  546.             otherwise the  overlay-manager will  assume RAMDRIVE  as the
  547.             name of the overlay-file and will search for it in F:\.
  548.  
  549.             In the second  case (2) you  point to the  location AND name
  550.             of the overlay-file. In this case the overlay-file can  have
  551.             a  complete  different  name.  So  it  is  valid to call the
  552.             program MTAHELL.EXE  and the  overlay MTAOVR.OVR  if you use
  553.             SET  MTAOVROL=C:\BBS\PRG\MTAOVR.OVR.  This  option  is  also
  554.             needed when you run under DOS 1.xx or 2.xx;
  555.  
  556.             The most  common usage  of this  environment variable  is to
  557.             put  the  overlay-file  on  a  RAM-disk (fast access) and to
  558.             deny the  usage of  EMS for  the overlay  (because you  have
  559.             better candidates for EMS usage).
  560.  
  561.  MTAOVRUE : This environment variable can have 2 values, either Y or  N.
  562.             The program will only test if the value 'N' is used (so  SET
  563.             MTAOVRUE=N). If this is  the case, the overlay  manager will
  564.             not  use  EMS  for  the  overlay-file  and  access  to   the
  565.             overlay-file is done on disk (see MTAOVROL);
  566.  
  567.  MTAOVRBS : This environment  variable can  be used  to alter  (enlarge)
  568.             the  overlay  buffer  in  conventional memory. The program's
  569.             default will give a good  average, but when memory is  not a
  570.             problem  (conventional  memory),  you  can  make the overlay
  571.             buffer bigger and  gain some speed  in the program  thruput.
  572.             To  see  which  value  you  should  set,  you should run the
  573.             program without this option first. Inside the log (you  must
  574.             activate the log),  you can find  the default value  for the
  575.             overlay buffer. You  can make it  smaller but don't  make it
  576.             smaller  than  the  current  size  minus  8192 otherwise the
  577.             overlay-manager  could  fail.  You  can  make  it bigger but
  578.             don't make it too big  (experiment with small steps and  see
  579.             if the  performance gets  better). SET  MTAOVRBS=100000 will
  580.             allocate  100.000  bytes  of  conventional  memory  for  the
  581.             overlay buffer;
  582.  
  583.  MTAOVRPS : This environment  variable can  be used  to alter  (enlarge)
  584.             the 'prohibition area'.  This area is  a part of  the normal
  585.             overlay buffer. It is used to store recently accessed  parts
  586.             of the code. The code  will remain as long as  possible over
  587.             here. If the code is  accessed again, it doesn't have  to be
  588.             loaded from the  overlay-file but can  come from this  area.
  589.             The value you supply with  this variable should not be  less
  590.             than 2. The default  is 3 (buffersize /  3). You can try  to
  591.             gain some speed by making  the overlay buffer larger and  to
  592.             set this  value to  2. The  default gives  a good average in
  593.             combination with most overlay buffers;
  594.  
  595.  In general (DOS version equal or higher than 3.xx, unaltered names  for
  596.  the program-file and overlay-file, enough  EMS memory or a fast  disk),
  597.  you can use the default values and don't have to set these  environment
  598.  variables.
  599.  
  600.  MTA's overlayed version  is available as a separate package (MTAOVxxx).
  601.  It is advised to use the  overlay  version when the remaining memory is
  602.  very low (when running  MTA  under a BBS door like FileDoor <tm>.
  603.  
  604.  
  605.  
  606.  3.2 Archivers
  607.  ───────────────────────────────────────────────────────────────────────
  608.  In the next chapters I will give some personal advise and some  remarks
  609.  on the various archivers that  are available and that MTA  can support.
  610.  If  you  are  an  inexperienced  user,  you can obtain some information
  611.  about archivers you haven't looked at, if you are a pro, you will  find
  612.  some remarks on the  various archivers that have  to deal with the  way
  613.  MTA converts from and to these kind of systems.
  614.  
  615.  
  616.  3.2.1 General remarks and suggestions on archivers
  617.  ───────────────────────────────────────────────────────────────────────
  618.  This  chapter   (3.2.1)  contains   some  PERSONAL   information  about
  619.  archivers in general. If you don't  know all the systems or if  you are
  620.  still in  search for  a better  one, this  chapter can  guide you  in a
  621.  certain way.  I won't start a discussion about the information in  this
  622.  chapter, neither with  the authors (beta-testers)  nor with the  users,
  623.  remember it  is my  personal point  of view,  after looking  at all  of
  624.  them. For starters, I  will URGE to say  that MTA supports ALL  archive
  625.  systems in the  BEST possible way,  so the fact  that I am  not using a
  626.  certain system does  not mean that  MTA does not  support it for  100%.
  627.  Some  other  vendors  supply  conversion  programs  from  all  (or one)
  628.  systems to all  (or one) other  system. Please be  warned that most  of
  629.  these programs ar  written with a  certain archive system  in mind. MTA
  630.  is not such a  program. I neither sell  nor develop any archive  system
  631.  myself  so  MTA  can  look  as  'objective'  as possible to any archive
  632.  system.
  633.  
  634.  The question 'which is the best  archive system for my situation' is  a
  635.  question that is  asked many times.  I can not  give 100% OK  answer to
  636.  this question but I can try. First you must ask yourself one  question.
  637.  WHY, besides  gaining disk  space,   should I  use an  archive program.
  638.  Here are some guidelines:
  639.  
  640.  -a) I  need as  much files  in on  my disks,  so HIGH compression is my
  641.      major goal;
  642.  
  643.  -b) I  want  to  create  compressed  files very quickly because I  have
  644.      either a slow machine or much archives to maintain;
  645.  
  646.  -c) I  want  to  make  my  archives  'transparent'  to  other types of
  647.      operating systems (called 'platforms' with a difficult word);
  648.  
  649.  -d) I need  to archive (and  store) files on  diskette that are  bigger
  650.      than my highest diskette format;
  651.  
  652.  -e) I want  some sort of  version control, so  when I add  a file to an
  653.      archive, any previous file with  the same name inside that  archive
  654.      must be kept as a backup (older level);
  655.  
  656.  I  am  sure  there  are  some  other  guidelines  to follow. For one, I
  657.  personally  like  a  good  and  bug-free  archive  program  with a good
  658.  feedback from users of  vendor when needed. But  let us take the  given
  659.  guidelines (a) to (e) and see what COULD be best for you. In the  given
  660.  order:
  661.  
  662.  -a) Most archivers can  compress to a very  small format but there  are
  663.      three groups  that differ  in size.  The first  group contains  ZIP
  664.      (2.xx),  LZH  (2.xx)  and  ARJ  (2.xx)  in  a random order. It is a
  665.      matter of 1  to 3 percent  depending on the  kind of files.  LZH is
  666.      free (with source-code) which can  be a bonus but also  a drawback.
  667.      The second group  contains ZOO (2.xx),  HYPER (25) and  PAK (2.xx).
  668.      ZOO 2.1x  is somewhere  between the  first and  second group, other
  669.      differ in speed and options. The remaining systems are combined  as
  670.      the third group;
  671.  
  672.  -b) When speed is  the main interest, ZIP  is your goal. LZH  (2.xx) is
  673.      also good and some of the  older systems can work fast. There  is a
  674.      rule that says, the higher  the compression, the more time  it will
  675.      take to  compress. Where  ARJ, ZIP  and LZH  make very com- pressed
  676.      files (within a the 5% bounds), ZIP outruns the others;
  677.  
  678.  -c) If  you want  to make  'portable' archives,  the choices are small.
  679.      Excluding OS/2  and to  my knowledge,  only LZH  and ZOO can create
  680.      transparent archives. ARJ  is working on  one and the  archives are
  681.      already prepared to be transparent;
  682.  
  683.  -d) For  this  feature  you  need  the so called multi-volume  support.
  684.      Only ARJ and ZIP (2.xx) support multi-volume support (MTA does  not
  685.      by the way);
  686.  
  687.  -e) Version  control is  an option  in demand  by programmers.  ARJ and
  688.      ZOO include  version control.  ZOO in  a somewhat  nicer way as ARJ
  689.      but   it  has  just  been  included  in  ARJ,  so there is room for
  690.      improvements;
  691.  
  692.  I think  that most  of the  users need  a combination  of -a)  and -b).
  693.  From the text you  can see that, unless  you need special tricks,  ARJ,
  694.  LZH and  ZIP are  the first  you should  try. If  you love many options
  695.  (and have a fast machine), you should take a look at ARJ.  If you  love
  696.  a good  simple interface  and very  speedy results,  ZIP is  your first
  697.  target and when  you want something  of both (and  the sources, AND  no
  698.  registration), LZH  would be  nice, though  it has  some drawbacks  (no
  699.  path-information, no  multi-volume). I  will skip  to ZIP  2.xx because
  700.  the AV-code is finally possible for non-USA users.
  701.  
  702.  
  703.  3.2.2 Remarks on ARC
  704.  ───────────────────────────────────────────────────────────────────────
  705.  MTA supports : All ARC versions up to 6.02
  706.  
  707.  There are no  special tricks concerning  ARC. When destination  is ARC,
  708.  FULL recursive support  is available if  you use the  SubstDrive option
  709.  in MTA.CTL, otherwise,  no recursive support  is available, due  to the
  710.  nature of ARC's recursive support.
  711.  
  712.  MTA is  NOT able  to detect  incoming encrypted  ARC-files. There is no
  713.  indication in the ARC whatsoever that an ARC-file is encrypted.  Please
  714.  be careful ! MTA IS able  to unARC encrypted ARC-files when you  supply
  715.  the correct switches to MTA;
  716.  
  717.  If you receive  files from the  newer (7.xx) version  of ARC (SEA)  but
  718.  you don't own ARC  7.xx, you can use  the UNARCPath option in  MTA.EXE.
  719.  This option can point to either ARCE.EXE or XARC.EXE. In that case  you
  720.  can decompress the  files and convert  them to another  system that you
  721.  CAN support.
  722.  
  723.  
  724.  3.2.3 Remarks on PAK
  725.  ───────────────────────────────────────────────────────────────────────
  726.  MTA supports : All PAK versions up to 2.51
  727.  
  728.  There are a  few things to  keep in mind  when using a  PAK version. If
  729.  you still use GSARC (the old PAK),  skip as fast as you can to  a newer
  730.  level (GSARC support will be removed from MTA, somewhere in 1993).
  731.  
  732.  There are some special tricks concerning PAK. When destination is  PAK,
  733.  FULL recursive support  is available if  you use the  SubstDrive option
  734.  in MTA.CTL, otherwise,  no recursive support  is available, due  to the
  735.  nature of PAK's recursive support.
  736.  
  737.  When adding comments to the PAK file (AutoComment option), up to  64000
  738.  bytes  are  allowed,  although  this  seems  to  be  more  than PAK can
  739.  support.
  740.  
  741.  MTA  is  NOT  able  to  detect  incoming  encrypted  PAK-files, see the
  742.  remarks on ARC files.
  743.  
  744.  NoGate Consulting  have released  a PAK  2.5x with  ZIP-support inside.
  745.  MTA is  NOT able  to use  PAK as  a substitution  for PKWare's ZIP. You
  746.  MUST use PKZIP/PKUNZIP to compress and decompress ZIP files !
  747.  
  748.  
  749.  3.2.4 Remarks on ZIP
  750.  ───────────────────────────────────────────────────────────────────────
  751. │MTA supports : All ZIP versions up to 2.04g
  752.  
  753.  When using   ZIP files   (as destination),   you must   remember to set
  754.  the  correct  compression  switches  in   the  ZIPCompression option in
  755.  MTA.CTL.  You can not (of  course) use a switch  that is not  supported
  756.  with your current  version  of  ZIP.   Also  be  sure  to  upgrade   to
  757.  the  highest  possible  version.  MTA  versions  up   to  14.57 contain
  758.  upgrade  support   to  upgrade  from  older   ZIP  (0.xx) to  newer ZIP
  759.  (1.xx)  formats. MTA 15.01 and up  still contain  upgrade support   but
  760.  now  for the   1.xx to  2.xx  versions of ZIP. MTA   will ignore  newer
  761.  ZIP  archives if you still  use an older ZIP version.
  762.  
  763.  MTA  is  able  to  detect  and  process  both  encrypted  ZIP-files and
  764.  ZIP-files  with  Authenticity  Verification  set  to  ON. MTA will skip
  765.  encrypted ZIP-files when no password is supplied to MTA.
  766.  
  767. │Be warned  that  the new PKZIP (2.xx) will not detect any AV-code in a
  768. │PKZIP  1.xx  archive (and the other way around). MTA *CAN* detect BOTH
  769. │situations but  the  version of PKZIP you use will deside if (and how)
  770. │the AV-code is shown to MTA.
  771.  
  772.  From 14.50 and  on, conversion of  volume-labels from and  to ZIP files
  773.  is available in MTA.
  774.  
  775.  
  776.  3.2.5 Remarks on PKPAK/PKUNPAK
  777.  ───────────────────────────────────────────────────────────────────────
  778.  MTA supports : All PKPAK/UNPAK versions up to 3.61
  779.  
  780.  There is  nothing special  in this  support. To  go along  with S.E.A.,
  781.  PKPAK/PKUNPAK  format  is  not  supported  as  destination, nor are the
  782.  (archive) comments inside a PKware created ARC-file;
  783.  
  784.  MTA is NOT able to  detect incoming encrypted PKPAK-files. There  is no
  785.  indication  in  the  ARC  whatsoever  that  a  PKPAK-file is encrypted.
  786.  Please be  careful !  MTA IS  able to  unPAK encrypted PKPAK-files when
  787.  you supply the correct switches to MTA.
  788.  
  789.  
  790.  3.2.6 Remarks on DWC
  791.  ───────────────────────────────────────────────────────────────────────
  792.  MTA supports : DWC version 5.10A
  793.  
  794.  No support for included directories.  You can set the type  of compress
  795.  (average, good) by means of the DWCCompression option in MTA.CTL.
  796.  
  797.  There are some special tricks concerning DWC. When destination is  DWC,
  798.  FULL recursive support  is available if  you use the  SubstDrive option
  799.  in MTA.CTL, otherwise,  no recursive support  is available, due  to the
  800.  nature of DWC's recursive support.
  801.  
  802.  MTA is able  to detect and  process DWC files  that are encrypted.  MTA
  803.  will skip an encrypted DWC-file when no password is supplied to MTA.
  804.  
  805.  
  806.  3.2.7 Remarks on ZOO
  807.  ───────────────────────────────────────────────────────────────────────
  808.  MTA supports : ZOO version 2.10
  809.  
  810.  There is nothing special in  this support. Full recursive and  relative
  811.  path support is  available. MTA also  supports ZOO 2.01  'extended' and
  812.  the new ZOO 2.10 with very small target files (high compression).
  813.  
  814.  You  can  set  high  compression  for  ZOO  by using the ZOOCompression
  815.  option with a value of h.
  816.  
  817.  When adding comments to the ZOO file (AutoComment option), up to  64000
  818.  bytes  are  allowed,  although  this  seems  to  be  more  than ZOO can
  819.  support.
  820.  
  821.  
  822.  3.2.8 Remarks on LHarc
  823.  ───────────────────────────────────────────────────────────────────────
  824.  MTA supports : All LHarc versions up to 2.13E
  825.  
  826.  There are some special tricks concerning LZH. When using LZH  (in/out),
  827.  FULL recursive support  is available if  you use the  SubstDrive option
  828.  in MTA.CTL, otherwise,  no recursive support  is available, due  to the
  829.  nature of LZH's recursive support.
  830.  
  831.  NEVER use versions 2.03 to 2.06. Please contact me if you want to  know
  832.  the details WHY MTA can not support these versions.
  833.  
  834.  Remember to set the LZHVersion option to the correct value !!!!!!!!!!
  835.  
  836.  
  837.  3.2.9 Remarks on LArc
  838.  ───────────────────────────────────────────────────────────────────────
  839.  MTA supports : LArc version 3.33
  840.  
  841.  MTA supports  LArc as  it can.  There is  no documentation available to
  842.  me, so everything comes from 'the dark'.
  843.  
  844.  There are some special tricks concerning LZS. When using LZS  (in/out),
  845.  FULL recursive support  is available if  you use the  SubstDrive option
  846.  in MTA.CTL, otherwise,  no recursive support  is available, due  to the
  847.  nature of LZS's recursive support.
  848.  
  849.  
  850.  3.2.10 Remarks on MD
  851.  ───────────────────────────────────────────────────────────────────────
  852.  MTA supports : MDCD version 1.00
  853.  
  854.  MTA supports MDCD. The  not so commonly used  MDCD program can be  used
  855.  both as source and as  target. Although the sources are  available, MTA
  856.  will use the stand-alone program MDCD.EXE for (de)compression.
  857.  
  858.  
  859.  3.2.11 Remarks on ARJ
  860.  ───────────────────────────────────────────────────────────────────────
  861. │MTA supports : ARJ  version 2.39d (probably also upcomming 2.40)
  862.  
  863.  Support for ARJ is rather straight forward. All standard functions  are
  864.  implemented but at  least ARJ 2.22  is needed because  MTA uses the  -+
  865.  option to switch off the SW_ARJ options.
  866.  
  867.  There is no  support for multi-volumes  and neither for  ARJ files with
  868.  backups  inside.  MTA  can  process  them correctly (even with extended
  869.  testing, see later) but it is up  to you what will happen. You can  set
  870.  the ARJCompression option in MTA to  whatever you like. If you add  the
  871.  -jo  switch,  ARJ  will   decompress  the  backup-versions  along   the
  872.  original, renaming the backup-versions.
  873.  
  874.  ARJ files with a security envelope  are supported but MTA will not  add
  875.  comments or files to these files  as with ZIP (ARJ disallows adding  of
  876.  these objects by reporting an invalid security envelope).
  877.  
  878.  ARJ contains the original  archive-name within the archive  itself. MTA
  879.  can use this  name and (optionally)  rename the source-archive  back to
  880.  that original name before conversion start (OriginalARJName option).
  881.  
  882.  Support for  the 2.10  volume labels  is added.  Please remember to put
  883.  the  KeepVolLabel  (/KEEPVL)  option  on  ONLY  in combination with ARJ
  884.  version 2.1x>. If you use ZIP  (1.1x>) and a lower version of  ARJ than
  885.  2.1x, conversion of the volume-labels  will cause ARJ to abort  and the
  886.  converted files to be moved to the error-directory !
  887.  
  888. │From MTA version 15.36, MTA can detect the difference  there is between
  889. │ARJ versions PRIOR to 2.39d and 2.39d and higher (security envelope and
  890. │the different header <sigh>).
  891.  
  892.  
  893.  3.2.12 Remarks on HYPER
  894.  ───────────────────────────────────────────────────────────────────────
  895.  MTA supports : HYPER version 25 (and up)
  896.  
  897.  This nice little  compression program from  Germany, is also  supported
  898.  in MTA. Testing  (to implement the  protocol in MTA)  gave results that
  899.  are in the same order as LHARC.
  900.  
  901.  MTA support the  recursive features in  HYPER. Any commenting  in a HYP
  902.  file is  impossible (yet)  and thus  not supported  by MTA. All comment
  903.  related features will do nothing on a HYP file.
  904.  
  905.  MTA will support HYPER SFX (self extracting archive) files.
  906.  
  907.  Also MTM, MTL and MTZ are changed to reflect the results of the  change
  908.  from or to HYPER and to do maintenance on these files.
  909.  
  910.  
  911.  3.2.13 Remarks on PKLITE
  912.  ───────────────────────────────────────────────────────────────────────
  913.  MTA supports : PKLITE version 1.15 (and up)
  914.  
  915.  It is a little off-topic type of program to be included in MTA, but  it
  916.  is. MTA (and  the selection-menu MTA.CH1)  is changed so  that you easy
  917.  convert  COM/EXE  files  to  compressed  (self-contained) COM/EXE files
  918.  with PKLITE. I think this is a useful bonus (and nothing more) to MTA.
  919.  
  920.  Why not  include LZEXE  you would  ask. The  reasons are  simple (and a
  921.  hint to the author, based on the current version 0.91):
  922.  
  923.  - LZEXE can only directly compress EXE files (COM files need a  special
  924.    conversion); - LZEXE can only go one way;
  925.  
  926.  In the near future I will think about adding the Japanese DIET  program
  927.  into MTA (it can do the same, and more, than PKLITE).
  928.  
  929.  When MTA  works in  (UN)PKLITE mode,  it can  only convert with PKLITE.
  930.  All other files (archives) are not converted.
  931.  
  932.  When MTA  ignores files  in the  selection, there  can be  a number  of
  933.  reasons. These are:
  934.  
  935.  With PKLITE:
  936.  
  937.  - The file is already PKLITE'ed;
  938.  
  939.  - The file is already LZEXE'ed;
  940.  
  941.  - The file is a SFX (Self extracting archive);
  942.  
  943.  With UNPKLITE:
  944.  
  945.  - The file is not PKLITE'ed;
  946.  
  947.  LZEXE files are left, because  it will create problems when  converting
  948.  these programs with PKLITE and when it does NOT create problems,  there
  949.  will be NO gain in size. SFX-files are left for the same reasons.
  950.  
  951.  
  952.  3.2.14 Remarks on GIFLITE
  953.  ───────────────────────────────────────────────────────────────────────
  954.  MTA supports : GIFLITE 1.41 (and up)
  955.  
  956.  With version 15.01,  MTA can also  convert GIF files.  There is support
  957.  for GIFLITE (registered and un-registered) without any drawbacks.
  958.  
  959.  
  960.  3.2.15 Remarks on JPEG
  961.  ───────────────────────────────────────────────────────────────────────
  962.  MTA supports : JPEG 15 (and up)
  963.  
  964.  There are various JPEG implementations. The one from Handmade  Software
  965.  is included for the moment.  The original programs from the  JPEG group
  966.  have reached DISP-HQ to late to be implemented.
  967.  
  968.  
  969.  3.2.16 Remarks on GIFTEST
  970.  ───────────────────────────────────────────────────────────────────────
  971.  MTA supports : GIFTEST 4.0ß
  972.  
  973.  MTA does  not use  any command-line  parameter in  the call to GIFTEST.
  974.  You can add some yourself (using MTA.CTL options and/or a  command-line
  975.  parameter for MTA). MTA is aware of all of the errorlevels that can  be
  976.  returned  by  GIFTEST.  If  you  include  command-line  parameters  for
  977.  GIFTEST that  cause the  GIF-file(s) to  be removed  if they are wrong,
  978.  MTA still try to move the file but without success. The only  'problem'
  979.  in this case, is the warning message you will receive. MTA is aware  of
  980.  all the errorlevels. 5 and 255 are converted to 'decompression  error'.
  981.  When you use  /L on the  GTECOMPRESSION option, be  sure to point  to a
  982.  place  (directory)  that  is  not  'owned'  by  MTA (so NOT the current
  983.  directory).  Use /M to  trigger when the dimensions are  not supported.
  984.  In that case MTA will move the file to the error-directory (lvl 20).
  985.  
  986.  
  987.  3.2.17 Remarks on SQZ
  988.  ───────────────────────────────────────────────────────────────────────
  989.  MTA supports : SQZ version 1.08.3
  990.  
  991.  This is a new compression/decompression program  from  Sweden. There is
  992.  contact between the SQZ author (Jonas I Hammarberg) and me, and  I will
  993.  try  to  update MTA  as  soon  as possible as there  are  new (changed)
  994.  versions of  SQZ that need a change in MTA !
  995.  
  996.  The performance of SQZ is the same or better than ARJ and the new PKZIP
  997.  (2.xx). The speed is somewhere between ZIP and ARJ, all in all it looks
  998.  very impressive and I have the  intention  (if possible) to support all
  999.  functions in SQZ.
  1000.  
  1001.  MTA does  NOT  support  the  c(omment) option of SQZ because SQZ itself
  1002.  (1.08.3) does   not  support  it yet. When  a  new   version  of SQZ is
  1003.  released  with this option active, you should not use it in combination
  1004.  with MTA 15.xx  but  wait  until the explicit support of this option is
  1005.  included in  MTA. MTA  is  unable  to  obtain  comments  FROM SQZ files
  1006.  (CarryComment 1 and 2  will  work but will use an empty string) but CAN
  1007.  add comments to SQZ files.
  1008.  
  1009.  Recursive support is  included  and MTA will always try to compress the
  1010.  files with  the  /p0 switch  (paths 'as-is'). To  use recursive support
  1011.  for source SQZ-files,  the  SUBSTDrive  support  is needed (as with all
  1012.  other archivers).
  1013.  
  1014.  Also MTM, MTL and MTZ are changed to reflect the results of the  change
  1015.  from or to HYPER and to do maintenance on these files.
  1016.  
  1017.  
  1018.  3.3 MTA.CTL
  1019.  ───────────────────────────────────────────────────────────────────────
  1020.  To let MTA  work, you must  create a configuration  file where MTA  can
  1021.  obtain  the  information  it  needs.  This  file  is  called MTA.CTL by
  1022.  default but can have any other  name (in which case you must  assign it
  1023.  to MTA by means of  a command-line option or an  environment variable).
  1024.  You can even have more configuration files for different tasks. If  you
  1025.  call the file  MTA.CTL and place  it as described  in chapter 3.1,  MTA
  1026.  will  find  it  without  the  use  of special forces like command-lines
  1027.  and/or  environment  variables.  In  this  DOCUMENTATION  we refer to a
  1028.  configuration file by its  original name (MTA.CTL). You  can substitute
  1029.  your filename in place.
  1030.  
  1031.  The configuration  file is  a normal  ASCII-file (text  file) which you
  1032.  can create and edit with line-editors like EDLIN or EDIT. You can  make
  1033.  the  file  as  big  as  you  want (by inserting many comment-lines) but
  1034.  remember that the size  has a relation with  the speed of reading  when
  1035.  MTA starts.  Large files will take MTA to do longer over the startup.
  1036.  
  1037.  The general formats of options are:
  1038.  
  1039.  OPTION  parameter parameter parameter .... parameter
  1040.  
  1041.  for active options, or:
  1042.  
  1043.  % comment
  1044.  
  1045.  for comments in  the configuration file.  In the documentation  we call
  1046.  the first parameter  'option' and the  secondary parameters are  called
  1047.  'parameter'.  For  parameters,  the  following  syntax  is  used in the
  1048.  description:
  1049.  
  1050.  [.....]   this  parameter is mandatory, it  MUST be present and  have a
  1051.            valid value;
  1052.  
  1053.  {.....}   this  parameter  is   optional.  If  it is NOT present,  some
  1054.            default is used;
  1055.  
  1056.  'value'   Values  between  quotes   must  be  coded WITHOUT the  quotes
  1057.            itself UNLESS specified;
  1058.  
  1059.  (*)       If this mark   occurs at the  end of the  options syntax,  it
  1060.            means that this option is  used by other programs in  the MTA
  1061.            package as  well. In  that case  refer to  the bottom  of the
  1062.            description to  see in  which program(s)  the option  is used
  1063.            also;
  1064.  
  1065.  There are  NO restrictions  to the  position you  start the option, nor
  1066.  the  starting  position  of  the  parameters,  but the 'option' and (if
  1067.  present) the  'parameters' have  to be  separated with  at least one or
  1068.  more spaces. You can make any mixture of upper and lower case !
  1069.  
  1070.  Some  of  the  parameters  in  the  MTA.CTL  file can be overruled with
  1071.  command-line switches. A generalized example of MTA.CTL is included  in
  1072.  the release-file. It contains ALL options available in this release.
  1073.  
  1074.  The following chapters will contain the several statements you can  use
  1075.  in MTA.CTL.  In the  documentation, the  statements are  put in logical
  1076.  groups.  These  groups  contain  statements  with  the  same  sort   of
  1077.  functions  or  serve  the  same  group  of  users.  The ACTUAL order of
  1078.  options in the configuration file does not matter at all.
  1079.  
  1080.  
  1081.  3.3.1 Basic statements
  1082.  ───────────────────────────────────────────────────────────────────────
  1083.  The following options are more or less basic options and should be used
  1084.  in any setup. Some of the statements can be left out, because they only
  1085.  add something extra or change the default that MTA itself assumes.
  1086.  
  1087.  ┌─────────────────────────────────────────────────────────────────────┐
  1088.  │ ARCPath     [path] {opt} {DynSwapSiz} {second path}              (*)│
  1089.  │ UNARCPath   [path] {opt} {DynSwapSiz} {second path}                 │
  1090.  │ PAKPath     [path] {opt} {DynSwapSiz} {second path}              (*)│
  1091.  │ ZOOPath     [path] {opt} {DynSwapSiz} {second path}              (*)│
  1092.  │ DWCPath     [path] {opt} {DynSwapSiz} {second path}              (*)│
  1093.  │ LZHPath     [path] {opt} {DynSwapSiz} {second path}              (*)│
  1094.  │ LZSPath     [path] {opt} {DynSwapSiz} {second path}              (*)│
  1095.  │ PKZIPPath   [path] {opt} {DynSwapSiz} {second path}              (*)│
  1096.  │ MDPath      [path] {opt} {DynSwapSiz} {second path}                 │
  1097.  │ PKUNZIPPath [path] {opt} {DynSwapSiz} {second path}              (*)│
  1098.  │ PKUNPAKPath [path] {opt} {DynSwapSiz} {second path}              (*)│
  1099.  │ ARJPath     [path] {opt} {DynSwapSiz} {second path}              (*)│
  1100.  │ HYPERPath   [path] {opt} {DynSwapSiz} {second path}              (*)│
  1101.  │ PKLITEPath  [path] {opt} {DynSwapSiz} {second path}                 │
  1102.  │ ZIP2EXEPath [path] {opt} {DynSwapSiz} {second path}                 │
  1103.  │ GIFLITEPath [path] {opt} {DynSwapSiz} {second path}                 │
  1104.  │ GIF2JPGPath [path] {opt} {DynSwapSiz} {second path}                 │
  1105.  │ JPG2GIFPath [path] {opt} {DynSwapSiz} {second path}                 │
  1106.  │ GIFTESTPath [path] {opt} {DynSwapSiz} {second path}                 │
  1107.  └─────────────────────────────────────────────────────────────────────┘
  1108.  Usage : These options point to the various archivers you have installed
  1109.          on your system. If you do not include statements for  archivers
  1110.          that ARE installed AND can  be found in the DOS-path,  MTA will
  1111.          search for them itself, so do not be surprised if, for example,
  1112.          you did not include the ZOOPath option but MTA is still able to
  1113.          work with ZOO files. In that case MTA has found ZOO.EXE in  the
  1114.          DOS-path !  If you  have all  archivers in  the DOS-path, it is
  1115.          still advised to include  the options for these  archivers. MTA
  1116.          will be able to pin-point  the archiver directly in this  case,
  1117.          causing a gain  of speed because,  otherwise, MTA will  start a
  1118.          'quest' for the archiver in the DOS-path.
  1119.  
  1120.          [Path]        This parameter must contain the drive,  directory
  1121.                        and filename  of the  archiver in  question.  MTA
  1122.                        will  validate  if  the  program  is at the given
  1123.                        location  and  terminate  with  an  error  if  it
  1124.                        isn't.
  1125.  
  1126.          {opt}         This  parameter  is optional. You  MUST  code  it
  1127.                        when  one  of  the  following  parameters is used
  1128.                        and/or if  you want  to change  the default. This
  1129.                        parameter  must  have  a  value  of either 'Y' or
  1130.                        'N'. The  value will  decide if  THIS archiver is
  1131.                        going to  be included  when you  want to optimize
  1132.                        your archive  on to  the smallest  size. All  the
  1133.                        archive programs that  do COMPRESSION and  have a
  1134.                        value of 'Y'  will be included  if you force  MTA
  1135.                        to  optimize  on  size  (/OOA on the command-line
  1136.                        or OptimizeOnSize  option in  MTA.CTL set).   'N'
  1137.                        will  cause  MTA  to  skip  this  archiver   when
  1138.                        optimize  is  running.  For  some  archivers  the
  1139.                        value is  not important  because they  either can
  1140.                        not COMPRESS (like PKUNZIP) or they have  nothing
  1141.                        to do with  normal file-compression (GIFLITE  and
  1142.                        such), but if  you code one  or more of  the next
  1143.                        parameters you  still must  include a  'Y' or 'N'
  1144.                        ('N' would be obvious.  'Y' is ignored) for  this
  1145.                        parameter;
  1146.  
  1147.          {DynSwapSiz}  This parameter  will instruct MTA if  swapping is
  1148.                        needed  before  the  (de)compression  program  is
  1149.                        actually  called.  In  previous  releases,   this
  1150.                        parameters was set to a fixed value ('SWAP')  but
  1151.                        with  15.01  and  up,  MTA uses DYNAMIC swapping.
  1152.                        You need to supply  the amount of memory  that is
  1153.                        needed to  run the  specific archive  program. In
  1154.                        the  included  example  of  MTA.CTL,  all minimal
  1155.                        values that worked are  included. If you need  at
  1156.                        least  250K  to  run  a specific archive program,
  1157.                        you must  code '256'  (or higher)  over here. For
  1158.                        some programs it is best to swap ALWAYS. In  this
  1159.                        case  a  value  of  '640'  will  do, because that
  1160.                        amount of CONVENTIONAL memory is NEVER  available
  1161.                        when MTA is running,  causing MTA to always  swap
  1162.                        before the archive  program is called.  With this
  1163.                        option you are more or less save when MTA is  run
  1164.                        from  a  secondary  shell.  Programs that need as
  1165.                        much  memory  as  possible  are  GIG2JPG, JPG2GIF
  1166.                        and, in some cases, ARJ.
  1167.  
  1168.          {second path} MTA (from 15.01)  can use two different sets  (or
  1169.                        versions) of a specific archiver. If you use  the
  1170.                        current PKZIP  and a  newer version  (or even  an
  1171.                        alpha or  beta) is  released, you  normally would
  1172.                        like  to  test  this  archiver  before  you start
  1173.                        using it.  For this  situation, you  can use this
  1174.                        parameter. You can rename your new version to  an
  1175.                        alternate name (f.i. P2ZIP.EXE) or you can  place
  1176.                        it in another directory.  When you have done  so,
  1177.                        you  can  include  the  full  path  to  this  new
  1178.                        program in  this parameter.  Now if  you run  MTA
  1179.                        with  the  /ALT  command-line,  MTA  will use the
  1180.                        program that is coded  over and not the  one that
  1181.                        is coded in the [path] parameter. If there is  no
  1182.                        {second  path}  option  included  but you run MTA
  1183.                        with /ALT, the program in [path] is used;
  1184.  
  1185.          Please notice that you must supply the correct programs to  the
  1186.          above  options.  If  you  replace  one  of  the  program's with
  1187.          another one, strange things  (errors) can occur and  data could
  1188.          corrupt.  Supply the following programs to the options:
  1189.  
  1190.          ARCPath             ARC.EXE     or its alias
  1191.          UNARCPath           XARC.EXE    or its alias (see ARC remarks)
  1192.          PAKPath             PAK.EXE     or its alias
  1193.          ZOOPath             ZOO.EXE     or its alias
  1194.          DWCPath             DWC.EXE     or its alias
  1195.          LZHPath             LHARC.EXE   or its alias
  1196.          LZSPath             LARC.EXE    or its alias
  1197.          PKZIPPath           PKZIP.EXE   or its alias
  1198.          MDPath              MDCD.EXE    or its alias
  1199.          PKUNZIPPath         PKUNZIP.EXE or its alias
  1200.          PKUNPAKPath         PKUNPAK.EXE or its alias
  1201.                           or PKXARC.COM  or its alias
  1202.                           or PKXARC.EXE  or its alias
  1203.          ARJPath             ARJ.EXE     or its alias
  1204.          HYPERPath           HYPER.EXE   or its alias
  1205.          ZIP2EXEPath         ZIP2EXE.EXE or its alias
  1206.          GIFLITEPath         GIFLITE.EXE or its alias
  1207.          JPG2GIFPath         JPG2GIF.EXE or its alias
  1208.                              You need to set DJPEG.EXE if you use
  1209.                              the StandardJPEG option (see later)
  1210.          GIF2JPGPath         GIF2JPG.EXE or its alias
  1211.                              You need to set CJPEG.EXE if you use
  1212.                              the StandardJPEG option (see later)
  1213.          GIFTESTPath         GIFTEST.EXE or its alias
  1214.  
  1215.          Where 'alias'  is the  name you  renamed the  original file to.
  1216.          Please supply  the complete  drive, directory  and filename  to
  1217.          any of the options !  If you leave the drive  and/or directory,
  1218.          MTA will replace it with the CURRENT drive and/or directory.
  1219.  
  1220.          If you don't own one  or more of the (de)compression  programs,
  1221.          leave out the related option, otherwise MTA will abort !
  1222.  
  1223.  Relate: None
  1224.  Dest. : All
  1225.  (*)   : Marked options are also in usage by: MTM
  1226.  
  1227.  
  1228.  ┌─────────────────────────────────────────────────────────────────────┐
  1229.  │ CompressionType [ttt]                                               │
  1230.  └─────────────────────────────────────────────────────────────────────┘
  1231.  Usage : This option sets the normal TARGET archive system. You can,  at
  1232.          any time,  overrule this  target with  another target.  In that
  1233.          case you can supply the correct command-line to do so.
  1234.  
  1235.          [ttt]          This sets the target. You can supply the  values
  1236.                        'ARC',  'PAK',  'ZIP',  'ZOO', 'LZH' (LHarc/LHA),
  1237.                        'LZS' (Larc), 'DWC',  'HYP', 'ARJ', 'MD'  (MDCD),
  1238.                        'PAKSFX',    'ZIPSFX',    'LZHSFX',     'ARJSFX',
  1239.                        'PKLITE',   'UNPKLITE',   'GIFLITE',   'GIF2JPG',
  1240.                        'JPG2GIF', 'GIF', 'SQZ', 'SQZSFX'  and     'OWN'.
  1241.  
  1242.                        Most of  them look  normal. Some  of them  don't.
  1243.                        The  PAKSFX,  ZIPSFX,  LZHSFX,  SQZSFX and ARJSFX
  1244.                        are the same  as PAK, ZIP,  LZH, SQZ and  ARJ but
  1245.                        also  include  the  creation  of an EXE/COM (SFX)
  1246.                        file.   The  PKLITE  can  be  used to convert EXE
  1247.                        files to PKLITE'ed  EXE files, the  UNPKLITE does
  1248.                        the reversed.   The GIFLITE  will convert  normal
  1249.                        GIF files to GIFLITE  GIF's.  The GIF2JPG  can be
  1250.                        used to convert GIF files to JPG files with  JPEG
  1251.                        and JPG2GIF  does the  reversed.   The value  GIF
  1252.                        will  cause  MTA  to  test  all GIF's (normal and
  1253.                        lite)  with  GIFTEST  (no  conversion, other than
  1254.                        removal of obsolete bytes, will be done).
  1255.  
  1256.                        OWN is  used when  you work  with a  special (not
  1257.                        normally supported  compression program,  see the
  1258.                        OWNxxxx options later on).
  1259.  
  1260.                        When set to  PKLITE/UNPKLITE, MTA will  only look
  1261.                        for  COM/EXE  files  that  can  be  converted  to
  1262.                        PKLITE or that are  converted with PKLITE.   When
  1263.                        set to  GIFLITE, GIF2JPG  or GIF,  MTA will  only
  1264.                        look  for  GIF  files,  when  set to JPG2GIF, MTA
  1265.                        will  only  look  for  files  with  the extension
  1266.                        '.JPG'. All other values  will cause MTA to  look
  1267.                        at all known archives.
  1268.  
  1269.          I suggest that you include  the most frequently used target  in
  1270.          MTA.CTL and use command-line switches to work with the  special
  1271.          ones  (so  set  CompressionType  to  ZIP  if ZIP is your normal
  1272.          target and use /PKLITE on  the command-line to let MTA  work on
  1273.          COM/EXE files when needed).
  1274.  
  1275.  Relate: None
  1276.  Dest. : All
  1277.  
  1278.  
  1279.  ┌─────────────────────────────────────────────────────────────────────┐
  1280.  │ LZHVersion [version] {alt version}                                  │
  1281.  │ PAKVersion [version] {alt version}                               (*)│
  1282.  │ ZIPVersion [version] {alt version}                               (*)│
  1283.  └─────────────────────────────────────────────────────────────────────┘
  1284.  Usage : These options set the version number for the various  archives.
  1285.          They are  needed because  the archivers  involved use different
  1286.          command-lines and/or internal  formats for different  versions.
  1287.          MTA can NOT auto-detect  the version-number (f.i. based  on the
  1288.          length of the  archive program) because  these programs can  be
  1289.          converted with PKLITE, DIET,  LZEXE or some other  EXE-compress
  1290.          program. You  MUST set  the manually  and you  MUST set them to
  1291.          the version you actually use !
  1292.  
  1293.          [version]     Must contain   the right  version. 1.10  must  be
  1294.                        translated to 110, 2.0  to 200, 1.13c to  113 and
  1295.                        so on.
  1296.  
  1297.          {alt version} If you use  the /ALT command-line option and  the
  1298.                        archiver  in  question  has  an alternate version
  1299.                        set  with  {second  path}  in the xxxPath option,
  1300.                        you  must  supply  the  version  number  of  this
  1301.                        program if  it is  not the  same as  the one  you
  1302.                        supplied  in  [version].  So  if  you  use   both
  1303.                        PKZIP.EXE (1.10) and  P2ZIP.EXE (2.01), you  must
  1304.                        code 'ZIPVersion 110 201'.  If you do not  supply
  1305.                        {alt version}, it will  be the same as  the value
  1306.                        set for [version] !
  1307.  
  1308.          Some  notes  about  the  various  differences between versions.
  1309.          For LZH, any value under 200  will cause MTA to give a  warning
  1310.          when a  2.xx archive  is found  (it will  skip the conversion).
  1311.          For ZIP, any value under 200  will cause MTA to give a  warning
  1312.          when a ZIP with a 2.xx format is detected (it will not  convert
  1313.          such a file). For PAK, the difference lies between 000  (GSArc)
  1314.          and 100 and  higher (GSArc does  not return an  errorlevel) and
  1315.          100-199 and 200 and higher (other formats in the PAK files).
  1316.  
  1317.          By default, MTA uses the versions 110 for ZIP, 251 for PAK  and
  1318.          213 for LHarc/LHA.
  1319.  
  1320.  Relate: None
  1321.  Dest. : LZH/PAK/ZIP
  1322.  (*)   : Marked options are also in usage by: MTM
  1323.  
  1324.  
  1325.  ┌─────────────────────────────────────────────────────────────────────┐
  1326.  │ StandardJPEG                                                        │
  1327.  └─────────────────────────────────────────────────────────────────────┘
  1328.  Usage : When this option is NOT set, MTA will assume the GIF2JPEG and
  1329.          JPEG2GIF programs from HandMade Software <tm> as the programs
  1330.          to convert to and from JPEG. If you set this option, MTA will
  1331.          call the supplied programs without any parameters so you can
  1332.          use the STANDARD CJPEG and DJPEG programs that come from the
  1333.          Independent JPEG Group <tm>.
  1334.  
  1335.  Relate: JPG2GIFPath, GIF2JPGPath
  1336.  Dest. : JPG/GIF
  1337.  
  1338.  
  1339.  ┌─────────────────────────────────────────────────────────────────────┐
  1340.  │ ZIPCompression     [parm..parm]                                  (*)│
  1341.  │ ZSFCompression     [parm..parm]                                     │
  1342.  │ DWCCompression     [parm..parm]                                     │
  1343.  │ ARJCompression     [parm..parm]                                     │
  1344.  │ ASFCompression     [parm..parm]                                     │
  1345.  │ ZOOCompression     [parm..parm]                                     │
  1346.  │ LZHCompression     [parm..parm]                                     │
  1347.  │ LSFCompression     [parm..parm]                                     │
  1348.  │ SQZCompression     [parm..parm]                                     │
  1349.  │ SSFCompression     [parm..parm]                                     │
  1350.  │ PKLITECompression  [parm..parm]                                     │
  1351.  │ GIFLITECompression [parm..parm]                                     │
  1352.  │ G2JCompression     [parm..parm]                                     │
  1353.  │ J2GCompression     [parm..parm]                                     │
  1354.  │ GTECompression     [parm..parm]                                     │
  1355.  └─────────────────────────────────────────────────────────────────────┘
  1356.  Usage : These options can be  used to add some extra parameters  to the
  1357.          compression program. Normally MTA uses the standard  parameters
  1358.          for each program  but some of  the programs can  have alternate
  1359.          parameters to set the density of the compression, the usage  of
  1360.          BIOS/Direct screen calls,  the detail of  reporting and so  on.
  1361.          You can add these options yourself (some suggestions are  given
  1362.          below) by  means of  these statements.  Those archive  programs
  1363.          that are NOT included,  don't have any useful  extra parameters
  1364.          that MTA should pass.
  1365.  
  1366.          [parm..parm]  When  you include the  options, you must  set the
  1367.                        parameters you want to  ADD to the ones  that MTA
  1368.                        already  adds.  You  can  code  them  just as you
  1369.                        would do  when you  called the  program from  the
  1370.                        command-line.
  1371.  
  1372.           The following options can  be used to add  (overrule) command-
  1373.           line parameters to the specific program:
  1374.  
  1375.           ZIPCompression     for PKZIP/PKUNZIP
  1376.           ZSFCompression     for ZIP2EXE
  1377.           DWCCompression     for DWC
  1378.           ARJCompression     for ARJ
  1379.           ASFCompression     for ARJ (when creating SFX files)
  1380.           ZOOCompression     for ZOO
  1381.           LZHCompression     for LZH
  1382.           LSFCompression     for LZH (when creating SFX files)
  1383.           SQZCompression     for SQZ
  1384.           SSFCompression     for SQZ (when creating SFX files)
  1385.           PKLITECompression  for PKLITE
  1386.           GIFLITECompression for GIFLITE
  1387.           G2JCompression     for GIF2JPG
  1388.           J2GCompression     for JPG2GIF
  1389.           GTECompression     for GIFTEST
  1390.  
  1391.          For ZIP you could add -es,  -en or -ex to overrule the  default
  1392.          type of  compression, for  ZOO you  could add  the 'h' for high
  1393.          compression (ZOO 2.1x),  for DWC you  could add the  'y' or 'z'
  1394.          for compression  on speed  or size,  of ARJ  the -jm1 parameter
  1395.          would be  nice and  also the  -jo statement  would be nice when
  1396.          you use  ARJ 2.3x+ and want  to convert any backups  inside the
  1397.          archives  as  well.  For  LHarc  the  /o option would force the
  1398.          older (1.13) method and  so we can go  on for a while.  Be sure
  1399.          to  add  only  extra  parameters.  The obvious ones are already
  1400.          passed by MTA  itself. The parameters  for encrypted files  and
  1401.          for special work  directories (and drives)  are also passed  by
  1402.          MTA, depending on other options !
  1403.  
  1404.  Relate: None
  1405.  Dest  : All
  1406.  (*)   : Marked options are also in usage by: MTM
  1407.  
  1408.  
  1409.  ┌─────────────────────────────────────────────────────────────────────┐
  1410.  │ OriginalARJName                                                     │
  1411.  └─────────────────────────────────────────────────────────────────────┘
  1412.  Usage : ARJ  keeps the name  of the archive  (when created) inside  its
  1413.          own  internal  structure.  Normally  you  would  nor  have  any
  1414.          problem with that, but there are users who rename the ARJ to  a
  1415.          name that fits  their own needs  better. When you  include this
  1416.          option in MTA.CTL, MTA will  FIRST rename the file back  to the
  1417.          ORIGINAL name inside  the ARJ-structure BEFORE  conversion will
  1418.          start. This  could be  useful but  please be  warned that  some
  1419.          third  party  archive-conversion  programs  first  create   the
  1420.          archive with a  temporary name before  renaming it to  the name
  1421.          it should  be. In  such case  a file  DSZ1212.ARJ could also be
  1422.          renamed  back  by  MTA  to  ZIPCONV$.$$$  before the conversion
  1423.          starts. In general, when  you receive files from  others, don't
  1424.          use the option, otherwise you could set it.
  1425.  
  1426.  Relate: None
  1427.  Source: ARJ
  1428.  
  1429.  
  1430.  
  1431.  3.3.2 Statements that define the environment that MTA uses
  1432.  ───────────────────────────────────────────────────────────────────────
  1433.  The following statements  all define a  part of the  actual environment
  1434.  that MTA.EXE will use. Included are statements that define the  several
  1435.  directories that MTA can use,  the minimal requirements for memory  and
  1436.  space on the drives, the swapping functions and so on.
  1437.  
  1438.  ┌─────────────────────────────────────────────────────────────────────┐
  1439.  │ TempPath [dir] {bytfree}                                            │
  1440.  └─────────────────────────────────────────────────────────────────────┘
  1441.  Usage : Most decompressors  can   use an  assigned work-directory.   It
  1442.          can be useful  to point this  work-directory to a  virtual disk
  1443.          (a  so called RAM-disk)  or to  the fastest  medium you   have,
  1444.          but,  in  most   cases,   you   must   sure   that  this  drive
  1445.          (directory) will contain  enough space to  hold  the  temporary
  1446.          work  files  for   the  largest   file   to     convert.   Some
  1447.          archivers   also  use   the environment variable TEMP to   look
  1448.          which directory  can   be used  for temporary   work-space.  In
  1449.          MTA you  can (optionally) assign the temporary directory   that
  1450.          will be  passed  to all  archivers  that can work with  such  a
  1451.          directory. In  most cases,   this will  cause the   archiver to
  1452.          use THIS   directory for   work-space and NOT  the one supplied
  1453.          in   the  variable  TEMP  (if  any).   In  doubt,  consult  the
  1454.          documentation of the archiver in question.
  1455.  
  1456.          [dir]         This value must point to a valid  drive/directory
  1457.                        which can  be used  for temporary  work-space. If
  1458.                        no drive  is supplied,  the default  one is used.
  1459.                        Relative  directories  (..\WRKDIR  and  such) are
  1460.                        not  advised  but  can  be  used (the are counted
  1461.                        from the CURRENT directory).
  1462.  
  1463.          {bytfree}     For  most conversions you need at least  a number
  1464.                        of  bytes  free  on  the  assigned work-directory
  1465.                        (drive).  To  make  sure  that  this  amount   is
  1466.                        present  on  that  drive,  you  can,  optionally,
  1467.                        supply the number of  bytes that must be  free as
  1468.                        the third  parameter. If  the number  of bytes on
  1469.                        the drive is LOWER  than the supplied value,  MTA
  1470.                        will not work and abort with an error. If you  do
  1471.                        not supply  a value,  MTA will  look if  at least
  1472.                        256K bytes  is available,  though that  could not
  1473.                        be enough in  some cases. If  you want to  ignore
  1474.                        the test at all, you can supply a value if 0.
  1475.  
  1476.  Relate: None
  1477.  Dest. : All
  1478.  
  1479.  
  1480.  ┌─────────────────────────────────────────────────────────────────────┐
  1481.  │ MTATempPath [dir] {bytfree}                                         │
  1482.  └─────────────────────────────────────────────────────────────────────┘
  1483.  Usage : For every  archive (and  other object)  that MTA will  convert,
  1484.          MTA creates (and later on removes) a temporary directory  UNDER
  1485.          the current directory. If this  is not what you want  (and this
  1486.          is advised), you must supply this option.
  1487.  
  1488.          [dir]         This value must point to a valid  drive/directory
  1489.                        which can be  used for temporary  directories. If
  1490.                        no drive  is supplied,  the default  one is used.
  1491.                        Relative  directories  (..\WRKDIR  and  such) are
  1492.                        not  advised  but  can  be  used (the are counted
  1493.                        from the  CURRENT directory).  In fact,  relative
  1494.                        directories for this option, are useless in  most
  1495.                        cases.
  1496.  
  1497.          {bytfree}     For  most conversions you need at least  a number
  1498.                        of bytes free on the assigned directory  (drive).
  1499.                        To make sure that this amount is present on  that
  1500.                        drive, you can, optionally, supply the number  of
  1501.                        bytes that must be  free as the third  parameter.
  1502.                        If  the  number  of  bytes  on the drive is LOWER
  1503.                        than the  supplied value,  MTA will  not work and
  1504.                        abort  with  an  error.  If  you  do not supply a
  1505.                        value, MTA will  look if at  least 256K bytes  is
  1506.                        available,  though  that  could  not be enough in
  1507.                        some cases.  If you  want to  ignore the  test at
  1508.                        all, you can supply a value if 0.
  1509.  
  1510.          MTA  will  create  temporary  directories UNDER this directory.
  1511.          The name  is 8  bytes long  (and when  you run  as a  second or
  1512.          third TASK, not child,  they also contain the  task-number) and
  1513.          will  represent  the  HEX  value  of  the  time/date  they were
  1514.          created.  When running as  a child of itself (arc-in-arc),  MTA
  1515.          will create temporary directories  with the name '$'  under the
  1516.          original first (8 byte) temporary directory.
  1517.  
  1518.          Some archivers (DWC as the  most important, related to MTA)  do
  1519.          not like  to see  points inside  a directory-name.  Such a name
  1520.          (f.i. DC33ABAF.1) can ONLY be  the LAST tree from the  root. As
  1521.          an  example,  C:\ZIP\DC33ABAF.1  is   allright  with  DWC   but
  1522.          C:\ZIP.ZIP\DC33ABAF.1 is NOT.
  1523.  
  1524.  Relate: ALTMTATempPath
  1525.  Dest. : All
  1526.  
  1527.  
  1528.  ┌─────────────────────────────────────────────────────────────────────┐
  1529.  │ ALTMTATempPath [dir] {bytfree}                                      │
  1530.  └─────────────────────────────────────────────────────────────────────┘
  1531.  Usage : When you have supplied the MTATemppath option, you can also
  1532.          supply this option. The format and usage of this option is
  1533.          the same as for the MTATempPath option.
  1534.  
  1535.          What is the usage of this option ? You can setup the normal
  1536.          MTATEMPPath option to point to a fast drive (like a RAM-disk).
  1537.          Normally a RAM-disk only contains a limited number of bytes
  1538.          and that can be a problem when big archives are converted.
  1539.          If there is not enough free space on the drive that is pointed
  1540.          to by the MTATempPath option, the archive(s) in question will
  1541.          be skipped.
  1542.  
  1543.          If you supply the ALTMTATempPath (along with the MTATEMPPath)
  1544.          you are out of trouble. IN MTATempPath you point to a RAM-disk
  1545.          of average size (or your fastest hard-disk). Most of the small
  1546.          archives will fit in the free space and are converted with a
  1547.          reasonable speed. Now if there are bigger archives that don't
  1548.          fit on that drive, MTA will swap to the drive (and directory)
  1549.          that is pointed to by the ALTMTATempPath option. This can be
  1550.          a normal hard-disk (or a slower one) with more free space. The
  1551.          big archives can still be converted !
  1552.  
  1553.          If an archive won't fit on either of the two drives, MTA will
  1554.          (as before) skip the archive.
  1555.  
  1556.  Relate: MTATempPath
  1557.  Dest. : All
  1558.  
  1559.  
  1560.  ┌─────────────────────────────────────────────────────────────────────┐
  1561.  │ MTAErrorPath [dir] {F|S[count]}                                     │
  1562.  └─────────────────────────────────────────────────────────────────────┘
  1563.  Usage : When  decompression   fails  (memory, corrupted archive and  so
  1564.          on), MTA will  put the original  archive (even though  it could
  1565.          not be OK)  into the temporary  directory that was  assigned to
  1566.          this file (the directory with  the 8-byte (or more) name  under
  1567.          the current directory  OR under the  directory assigned in  the
  1568.          MTATempPath  option   (see  above).   This  will   lead  to   a
  1569.          maintenance  problem  when  much  archives  fail. All corrupted
  1570.          files are moved to different directories and you need tools  to
  1571.          move  (or  delete)  them  all  AND  to  remove  the   temporary
  1572.          directories.  If  you  do  not  want  this maintenance, you can
  1573.          assign a  special directory  where MTA  places such  files. All
  1574.          you have to do, is to include this option in MTA.CTL.
  1575.  
  1576.          [dir]         This value must point to a valid  drive/directory
  1577.                        which  can  be  used  for  files  in error. If no
  1578.                        drive  is  supplied,  the  default  one  is used.
  1579.                        Relative  directories  (..\WRKDIR  and  such) are
  1580.                        not  advised  but  can  be  used (the are counted
  1581.                        from the  CURRENT directory).  In fact,  relative
  1582.                        directories for this option, are useless in  most
  1583.                        cases.
  1584.  
  1585.          {F|S[count]}  When this parameter is present, MTA will stop the
  1586.                        conversion when [count] number of files (when you
  1587.                        use F) or  bytes  (when you  use S) is present in
  1588.                        [dir]. For  example, F200  will cause MTA to stop
  1589.                        when there  are  200  or  more files in [dir] and
  1590.                        S200000 will  cause MTA to stop when all combined
  1591.                        files in [dir] come to (or exceed) 200.000 bytes.
  1592.  
  1593.  Relate: None
  1594.  Dest. : All
  1595.  
  1596.  
  1597.  ┌─────────────────────────────────────────────────────────────────────┐
  1598.  │ FDUTempPath  [dir]                                                  │
  1599.  │ FDUTrashPath [dir]                                                  │
  1600.  └─────────────────────────────────────────────────────────────────────┘
  1601.  Usage : When you want to  convert whole diskettes to a new  system (use
  1602.          the /D switch,  see later), you  need two special  directories.
  1603.          Without these  directories you  can still  convert archives  on
  1604.          diskette but  you can't  use the  special options  that MTA can
  1605.          offer when  converting diskettes.  There is  a special  chapter
  1606.          about the conversion of diskettes.
  1607.  
  1608.          [dir]         This value must point to a valid  drive/directory
  1609.                        which can be used the  /D option. If no drive  is
  1610.                        supplied,  the  default  one  is  used.  Relative
  1611.                        directories (..\WRKDIR and such) are not  advised
  1612.                        but  can  be  used  (the  are  counted  from  the
  1613.                        CURRENT  directory).   The  directories  must NOT
  1614.                        point  to  the  same  drive  as  you are going to
  1615.                        convert. For a 'mixed' (HDU and FDU) system,  you
  1616.                        must  assign  the  HDU,  for  a  'single'  (FDU 2
  1617.                        times)  system,  you  must  assign a directory on
  1618.                        the other diskette station.
  1619.  
  1620.  Relate: /D option
  1621.  Dest. : All
  1622.  
  1623.  
  1624.  ┌─────────────────────────────────────────────────────────────────────┐
  1625.  │ ITSPath [dir]                                                       │
  1626.  └─────────────────────────────────────────────────────────────────────┘
  1627.  Usage : MTA can be used  in combination with ITS (version 1.06  and all
  1628.          higher versions). When  used in combination  with ITS, MTA  can
  1629.          be stopped like pressing the ESC-key but now without any  human
  1630.          actions involved.  The stopping  of MTA  is ruled  from the ITS
  1631.          task(s) that are running.
  1632.  
  1633.          [dir]         This value must point to a valid  drive/directory
  1634.                        which contains the ITS.SPH  file. If no drive  is
  1635.                        supplied,  the  default  one  is  used.  Relative
  1636.                        directories (..\WRKDIR and such) are not  advised
  1637.                        but  can  be  used  (the  are  counted  from  the
  1638.                        CURRENT directory).
  1639.  
  1640.          MTA MUST find the ITS.SPH file, otherwise MTA will abort,  even
  1641.          when ITS is not  currently in use. If  you don't have (or  use)
  1642.          ITS, you must leave this option OFF.
  1643.  
  1644.  Relate: None
  1645.  Dest. : All
  1646.  
  1647.  
  1648.  ┌─────────────────────────────────────────────────────────────────────┐
  1649.  │ SwapPath [dir]                                                      │
  1650.  └─────────────────────────────────────────────────────────────────────┘
  1651.  Usage : MTA can  (and will)  use a  mechanism to  clear memory when  it
  1652.          needs to. This technique  is called swapping. Swapping  will do
  1653.          the following:
  1654.  
  1655.          - All  data structures  that MTA  uses are  compressed together
  1656.            and written to the swapping device;
  1657.  
  1658.          - All program-coding minus a small piece (the program code  for
  1659.            the swapping itself) will be written to the swapping device;
  1660.  
  1661.          - Memory  is  cleared  an  will  be  rearranged  so it will  be
  1662.            (again) one continuous piece of memory;
  1663.  
  1664.          - The external  program (compressor, decompressor,  exit, virus
  1665.            checker and so on) is called and uses the freed memory;
  1666.  
  1667.          - After termination of the external program, control is  passed
  1668.            to the swapping-code that remained in memory;
  1669.  
  1670.          - The  coding will  (again) rearrange  memory as  it was,  will
  1671.            read   the   program-coding   back   AND   will   read    all
  1672.            data-structures back;
  1673.  
  1674.          - It will clean the swapping device;
  1675.  
  1676.          - It will pass control back to the point where MTA was;
  1677.  
  1678.          With  this  technique,  around  230.000  bytes are removed from
  1679.          memory. These 230.000  were in use  by MTA (non-overlayed)  and
  1680.          there  will  remain  only  a  couple  of bytes for the swapping
  1681.          itself (around 4K bytes).
  1682.  
  1683.          Normally  the  swapping  device  can  be  any  of the following
  1684.          resources:
  1685.  
  1686.          - EMS
  1687.            First   choice,   unless   the   NoEMS   option   (or  /NOEMS
  1688.            command-line parameter)  is supplied  or there  is not enough
  1689.            EMS to contain all data (ca. 230.000 bytes);
  1690.  
  1691.          - XMS
  1692.            Second choice  in SOME  cases. Not  all swapping  routines in
  1693.            MTA  can   support  XMS   yet.  If   the  NoXMS   (or  /NOXMS
  1694.            command-line parameter)  is supplied  or there  is not enough
  1695.            (or no)  XMS to  contain all  data (ca.  230.000 bytes),  MTA
  1696.            will use the next resource;
  1697.  
  1698.          - Disk
  1699.            When there is  not enough (or  no) EMS or  XMS (or the  NoEms
  1700.            and/or NoXMS options are active),  MTA will use disk for  the
  1701.            swapping;
  1702.  
  1703.          When  MTA  is  forced  to  use  disk,  it  will use the current
  1704.          directory for the swap-file that will be created. You can  (and
  1705.          sometimes MUST) overrule this with this option.
  1706.  
  1707.          [dir]         This value must point to a valid  drive/directory
  1708.                        which contains the swapping file. If no drive  is
  1709.                        supplied,  the  default  one  is  used.  Relative
  1710.                        directories (..\WRKDIR and such) are not  advised
  1711.                        but  can  be  used  (the  are  counted  from  the
  1712.                        CURRENT directory).
  1713.  
  1714.          You can also assign a directory  on a RAM-disk when you have  a
  1715.          large one. The only place where MTA disallows disk-swapping  is
  1716.          on  REMOVABLE  drives  (diskettes).  The swap-file (if created)
  1717.          has a  special (unique)  name and  will have  the HIDDEN/SYSTEM
  1718.          attribute. You must NEVER try  to remove such a file  while MTA
  1719.          is still running. It will cause a hangup !
  1720.  
  1721.  Relate: All swapping options
  1722.  Dest. : All
  1723.  
  1724.  
  1725.  ┌─────────────────────────────────────────────────────────────────────┐
  1726.  │ NoEMS                                                               │
  1727.  │ NoXMS                                                               │
  1728.  └─────────────────────────────────────────────────────────────────────┘
  1729.  Usage : When you do not want MTA to use either (or both) EMS or (and)
  1730.          XMS, you can add these option(s) to MTA.CTL. When NoEMS is set
  1731.          and NoXMS isn't and you use QEMM or 386Max (or some program
  1732.          like that), XMS is used. When you set both options, only disk
  1733.          is used. These options are related to the swapping mechanism.
  1734.          This mechanism is the only mechanism in MTA that can make use
  1735.          of EMS/XMS.
  1736.  
  1737.  Relate: All swapping options
  1738.  Dest. : All
  1739.  
  1740.  
  1741.  ┌─────────────────────────────────────────────────────────────────────┐
  1742.  │ MoveToDir [dir]                                                     │
  1743.  └─────────────────────────────────────────────────────────────────────┘
  1744.  Usage :  MTA can,  optionally, move  archives (and  all other converted
  1745.          objects) to another directory  AFTER the conversion. There  are
  1746.          currently 2 different  ways to obtain  this result. One  is the
  1747.          usage of the DefaultPath option (see later), which can be  used
  1748.          by most SysOp's of Bulletin Boards. The other one, the  current
  1749.          option, can be used when  you want to move all  converted files
  1750.          from any directory that you wish to use to a new one.  Normally
  1751.          you will use the  command-line /M to do  so, but if you  always
  1752.          want to have the converted archives on the same place, you  can
  1753.          use the MoveToDir option.
  1754.  
  1755.          [dir]         This value must point to a valid  drive/directory
  1756.                        where  the  files  are  moved  to. If no drive is
  1757.                        supplied,  the  default  one  is  used.  Relative
  1758.                        directories (..\WRKDIR and such) are not  advised
  1759.                        but  can  be  used  (the  are  counted  from  the
  1760.                        CURRENT directory).
  1761.  
  1762.          There  is  one  special  format.  When  combining the /D option
  1763.          (diskette conversion)  with the  MoveToDir (or  the /M command-
  1764.          line parameter), MTA will  convert diskettes from one  diskette
  1765.          to another  one. If  you mix  runs of  MTA to convert diskettes
  1766.          AND to  do normal  conversion, you  can get  problems when this
  1767.          option is put into the MTA.CTL. In such cases it is advised  to
  1768.          use the /M command-line parameter.
  1769.  
  1770.          WARNING: When  you  use  MoveToDir  in  conjunction  with   the
  1771.                   ExitAfterCompression option  you have  to be  aware of
  1772.                   the following extra's:
  1773.  
  1774.                   - When you create an  extra file in the exit  with the
  1775.                     extension  .COM  or  .EXE  which  is  in  the   same
  1776.                     directory   as   the   original   compressed   file,
  1777.                     MoveToDir moves these files also.  When a  name-like
  1778.                     file  already   exist  in   the  MoveToDir    target
  1779.                     directory, MTA  gives you  a warning  and leaves the
  1780.                     file  where  it  was.  This  does  not  go  for  the
  1781.                     original compressed file;
  1782.  
  1783.                   - When  you delete  the original  compression file  in
  1784.                     the  exit,  MTA  will  notice  this and will take no
  1785.                     further actions;
  1786.  
  1787.          When you are running 4Dos <tm> and your original files  contain
  1788.          a  description  in  the  4Dos  description  file,  MTA will use
  1789.          4DOS's MOVE command  to move any  files (if MTA  has detected a
  1790.          full 4DOS environment and the Not4DosAware option is not  set).
  1791.          This  will  cause  any  descriptions  (added  with  4DOS) to be
  1792.          carried along to the new directory.
  1793.  
  1794.  Relate: Not4DosAware, /D command-line parameter
  1795.  Dest. : All
  1796.  
  1797.  
  1798.  ┌─────────────────────────────────────────────────────────────────────┐
  1799.  │ FreeMemory [minfree]                                                │
  1800.  └─────────────────────────────────────────────────────────────────────┘
  1801.  Usage : MTA  uses  memory   very  dynamically.  When  you   convert two
  1802.          different directories you will see that the starting amount  of
  1803.          free memory (displayed by MTA) will never be the same. To  make
  1804.          the  story  short,  almost  every  option  that  can be entered
  1805.          multiple  times  (like  DoNot,  DefaultPath, IncludeFile and so
  1806.          on) will take a  few extra bytes of  memory and all files  that
  1807.          will be  converted (up  to 1000  in one  run) will  also take a
  1808.          dynamic amount of memory. All external calls can be ruled  with
  1809.          a  swap  option  (see  xxxPath,  Virusscanner and all exits) so
  1810.          that is not such  a problem. Also MTA  will take a look  at the
  1811.          memory and  will determine  if it  is possible  to make  itself
  1812.          useful in the presented amount  of bytes. If you still  want to
  1813.          abort  MTA  when  a  specific  number  of  free  bytes  in  NOT
  1814.          available, you can add this option to MTA.CTL.
  1815.  
  1816.          [minfree]     This value must be the number of BYTES (not  KILO
  1817.                        bytes)  that  must  be  free  in order to let MTA
  1818.                        start the conversion.
  1819.  
  1820.          By default MTA will look if  256Kb is free in memory after  all
  1821.          structures are build in memory. You can overrule the test  when
  1822.          you supply 'FreeMemory 0'.
  1823.  
  1824.  Relate: None
  1825.  Dest. : All
  1826.  
  1827.  
  1828.  ┌─────────────────────────────────────────────────────────────────────┐
  1829.  │ Runtime [seconds]                                                   │
  1830.  └─────────────────────────────────────────────────────────────────────┘
  1831.  Usage : MTA can be  interrupted when running attended (by  pressing the
  1832.          ESC key)  but when  you run  UNattended this  can be a problem.
  1833.          When you want to  run MTA for a  certain time (when MTA  is run
  1834.          inside a BBS event for instance), you can supply this option.
  1835.  
  1836.          [seconds]     This value  must be set to the number of  seconds
  1837.                        that MTA must execute.
  1838.  
  1839.          If the time is  over and there are  still files left, MTA  will
  1840.          skip them. To  make sure that  already converted files  are not
  1841.          converted again, it is advised  to either move them to  another
  1842.          directory, use MTA's marking-technique or use the option  where
  1843.          MTA will only convert files that have an earlier date then  the
  1844.          file FILES.MTA (a semaphore file, see later).
  1845.  
  1846.          MTA will always  run somewhat longer  than [seconds]. MTA  will
  1847.          not stop in the middle of a conversion so the one that  started
  1848.          [seconds]-1 will be finished. If  this is a big one,  some time
  1849.          can pass before MTA will terminate.
  1850.  
  1851.  Relate: None
  1852.  Dest. : All
  1853.  
  1854.  
  1855.  ┌─────────────────────────────────────────────────────────────────────┐
  1856.  │ Not4DosAware                                                        │
  1857.  └─────────────────────────────────────────────────────────────────────┘
  1858.  Usage : MTA will do some  internal DOS-calls to see if 4DOS  is present
  1859.          in the machine. If so, MTA will use 4DOS's move on any move  of
  1860.          a file that  will be done  inside MTA. If  there is no  4DOS in
  1861.          usage,  MTA  will  use  its  own  internal  (and quicker) MOVE.
  1862.          4DOS's MOVE is  used to move  any descriptions inside  the file
  1863.          DESCRIPT.ION (a 4DOS internal file which can be present  inside
  1864.          the directory with a HIDDEN attribute).
  1865.  
  1866.          If you don't  use 4DOS descriptions  for your files  and/or you
  1867.          want to use the faster internal  MOVE AND you run 4DOS on  your
  1868.          machine, you can include this option.
  1869.  
  1870.  Relate: MoveToPath (and all internal moves)
  1871.  Dest. : All
  1872.  
  1873.  
  1874.  ┌─────────────────────────────────────────────────────────────────────┐
  1875.  │ VideoMode [mode]                                                    │
  1876.  └─────────────────────────────────────────────────────────────────────┘
  1877.  Usage : MTA can adjust  itself to non-standard text-modes. Some  of the
  1878.          more common examples are 80x43, 132x60 and so on. If you  enter
  1879.          MTA  when  the  screen  is  such  a  mode,  MTA will extend the
  1880.          display in  the actual  number of  lines and,  with modes  that
  1881.          support  more  than   110  characters,  also   the  number   of
  1882.          characters on a line.
  1883.  
  1884.          If you  normally run  in a  normal text-mode  (80x25) but still
  1885.          want to  see MTA  running in  a special  text-mode, you can add
  1886.          this statement to MTA.CTL.
  1887.  
  1888.          [mode]        This  is the  decimal number of  the video   mode
  1889.                        that  MTA  will  try  to  set.  Look  inside your
  1890.                        video-card manual  to see  which mode  you should
  1891.                        use.
  1892.  
  1893.          After MTA  has processed  the MTA.CTL  options, MTA  will reset
  1894.          the video-card to  the supplied mode  (if included in  MTA.CTL)
  1895.          and before termination,  MTA will reset  to the standard  text-
  1896.          mode. If you use an invalid mode, damage to your monitor  could
  1897.          be the case (see video-card manual) or you are not able to  see
  1898.          anything  until  MTA  has  finished  (or  the  machine can even
  1899.          hang).
  1900.  
  1901.          MTA will not alter the video-mode if it can detect that  it  is
  1902.          called under a multi-tasking environment like DesqView <tm>. In
  1903.          these cases the VIDEOMODE option will be obsolete.
  1904.  
  1905.  Relate: None
  1906.  Dest. : All
  1907.  
  1908.  
  1909.  ┌─────────────────────────────────────────────────────────────────────┐
  1910.  │ SubstDrive [drivearray]                                             │
  1911.  └─────────────────────────────────────────────────────────────────────┘
  1912.  Usage : This is a VERY  important option. Most archives include the  so
  1913.          called directory entries. These  are the directories that  were
  1914.          included when the archive was created. If an archive was  made,
  1915.          containing all files (*.*)  from the current directory  and all
  1916.          lower trees AND you supplied the options to include the  actual
  1917.          directories,  given  the  following  structure  (root  is   the
  1918.          current directory):
  1919.  
  1920.          [root, current directory, drive C]
  1921.             CONFIG.SYS
  1922.             [sub-dir HLP]
  1923.             TEST.TST
  1924.                 [sub-dir ZIP]
  1925.                 TEST.TST
  1926.                 [sub-dir ZAP]
  1927.                 TEST.TST
  1928.                    [sub-dir ZA1]
  1929.                    TEST.TST
  1930.                    [sub-dir ZA2]
  1931.                    TEST.TST
  1932.  
  1933.          the  archive  will  contain  one  of the two following formats,
  1934.          either the relative directories:
  1935.  
  1936.          CONFIG.SYS
  1937.          HLP\TEST.TST
  1938.          HLP\ZIP\TEST.TST
  1939.          HLP\ZAP\TEST.TST
  1940.          HLP\ZAP\ZA1\TEST.TST
  1941.          HLP\ZAP\ZA2\TEST.TST
  1942.  
  1943.          or the absolute directories:
  1944.  
  1945.          \CONFIG.SYS
  1946.          \HLP\TEST.TST
  1947.          \HLP\ZIP\TEST.TST
  1948.          \HLP\ZAP\TEST.TST
  1949.          \HLP\ZAP\ZA1\TEST.TST
  1950.          \HLP\ZAP\ZA2\TEST.TST
  1951.  
  1952.          The fact  if there  are ABSOLUTE  or RELATIVE  directories will
  1953.          depend on  the type  of archive  system. Normally  (without the
  1954.          SubstDrive option  set), MTA  will only  convert directories if
  1955.          the  source  archive  system  contains RELATIVE directories AND
  1956.          the target archive system  can contain directory entries.   For
  1957.          some  archivers  you  can  not  be  sure about the fact if they
  1958.          contain ABSOLUTE  or RELATIVE  directories and  some will  ONLY
  1959.          contain  ABSOLUTE  entries.  When  MTA  would  convert  such an
  1960.          archive, it would extract the  archive with all options into  a
  1961.          directory  F:\JUST\AN\EXAMPLE\156DA12F  (just  an  example) but
  1962.          while  decompress  starts,  the  decompress  program  would add
  1963.          files in ABSOLUTE directories, causing NONE of the files to  be
  1964.          added to F:\JUST\AN\EXAMPLE\156DA12F. Files would be stored  in
  1965.          C:\,  C:\HLP\,  C:\HLP\ZIP,  C:\HLP\ZAP,  C:\HLP\ZA1  and   the
  1966.          C:\HLP\ZA2 directory.
  1967.  
  1968.          MTA would be  able to notice  this and could  archive the files
  1969.          from  these  directories  back  into  the new archive (with the
  1970.          delete option) but  there are too  many risks involved.  MTA is
  1971.          created so  UNATTENDED operation  is possible.  To secure this,
  1972.          all warnings  and queries  are suppressed.  MTA would  start to
  1973.          call  the  decompress  program  and  the  first thing that will
  1974.          happen is the overwrite of  CONFIG.SYS on C:\ (all other  files
  1975.          look like if they will  not cause any trouble). When  MTA would
  1976.          start the target-compression program, CONFIG.SYS would then  be
  1977.          archived AND  deleted, leaving  C: without  CONFIG.SYS. Can you
  1978.          imagine what would  happen if files  like IO.SYS and  MSDOS.SYS
  1979.          would be extracted to the root or COMMAND.COM ?
  1980.  
  1981.          Given the  example above,  MTA will  NEVER decompress  archives
  1982.          that could  contain ABSOLUTE  directories unless  you use  some
  1983.          special options. There ARE many archives that have a  structure
  1984.          like this AND you  would still be able  to convert them but  in
  1985.          all cases WITHOUT any risk involved.
  1986.  
  1987.          For this reason, MTA  contains support for SUBSTituted  drives.
  1988.          If you don't know what  the command SUBST means under  DOS, you
  1989.          should read the DOS manual.  In short, SUBST will create  a new
  1990.          drive-letter and the root of  this drive is the same  directory
  1991.          as you supply  to SUBST. So  when you make  a SUBST drive  (G:)
  1992.          from F:\JUST\AN\EXAMPLE\156DA12F (see above), G:\ would be  the
  1993.          same  as   F:\JUST\AN\EXAMPLE\156DA12F  and   all   directories
  1994.          created under G:\ would in fact be created under the  directory
  1995.          F:\JUST\AN\EXAMPLE\156DA12F.  With  this  trick  (which  is   a
  1996.          normal DOS command), you CAN convert archives with  directories
  1997.          that  are  ABSOLUTE  and  you  can  still convert archives with
  1998.          RELATIVE  directories.  If  you  include the SubstDrive option,
  1999.          all  archives  WITH  directories,  no  matter  the  type of the
  2000.          directories, will convert in the  BEST possible way to the  new
  2001.          target (if  the new  target does  not support  directories, MTA
  2002.          can't fix that, but if it does, they will be there).
  2003.  
  2004.          There are some precautions to  take before you start with  this
  2005.          option. First, your DOS must support SUBSTituted drives:
  2006.  
  2007.          - Your DOS  must support SUBSTituted  drives. All DOS  versions
  2008.            from  3.0  and  up  will  contain the support for SUBSTituted
  2009.            drives;
  2010.  
  2011.          - You need the DOS program that can make and delete these  kind
  2012.            of SUBSTituted drives. This  program is called SUBST  (EXE in
  2013.            most cases, sometimes COM).   It would be possible to  have a
  2014.            self-contained  support  in  MTA  but  the  methods to create
  2015.            SUBSTituted drives  vary every  DOS release.  Make sure  that
  2016.            the program  SUBST.EXE or  SUBST.COM is  somewhere inside the
  2017.            DOS-path (MTA will search for the file itself and will  abort
  2018.            if  the  SubstDrive  option  is  set  but  the  SUBST.EXE/COM
  2019.            program isn't found);
  2020.  
  2021.          - You  must alter  the LASTDRIVE  option in  CONFIG.SYS (or set
  2022.            with one of  the QEMM <tm>  utilities) to a  higher value. If
  2023.            your current last drive is F:  and you are going to run  only
  2024.            ONE MTA at a time (it  is possible to run multiple copies  at
  2025.            the same time  under any multi-tasker  like DesqView <tm>  or
  2026.            MS Windows <tm>), you can set it to G:. In fact, you need  as
  2027.            much extra drives as  the number of concurrently  running MTA
  2028.            programs.  If  you  have   a  variable  drive   configuration
  2029.            (sometimes you have a  RAM-disk, sometimes you haven't),  you
  2030.            can also assign a much higher letter. In fact, it is  allowed
  2031.            to use drive Z: for SUBSTituted drives, even if the last  one
  2032.            is F:. In doubt, you  must leave out the LASTDRIVE  option in
  2033.            CONFIG.SYS;
  2034.  
  2035.          - You  must test  the SUBST  program manually  to make  sure is
  2036.            works. Use a directory and  try SUBST on all drives  that are
  2037.            going to use in MTA;
  2038.  
  2039.          If all  points above  are checked,  you can  add the SubstDrive
  2040.          option in MTA.  If you use  the SubstDrive option  with invalid
  2041.          letters things  CAN go  wrong. I  strongly advise  to use drive
  2042.          letters that are NEVER  going to be used  (f.i. Y: and Z:  when
  2043.          running 2  concurrent MTA's  or only  Z: if  you only use one).
  2044.          It IS  possible but  NEVER use  a drive  letter that  is one of
  2045.          your CURRENT drives and certainly  not one of the floppy  drive
  2046.          letters if you want to use the /D option !
  2047.  
  2048.          [drivearray]   You must  supply at  least one  drive-letter but
  2049.                        you  can  supply  op  to  26.  You  must supply a
  2050.                        different  letter  for  each  concurrent MTA that
  2051.                        you  are  going  to  run.  The first MTA (task 1)
  2052.                        uses  the  first  letter,  the  next MTA (task 2)
  2053.                        will  use  the  second  and  so  on  !  With  all
  2054.                        warnings  in  mind,  you  could supply the option
  2055.                        'SubstDrive  Z'  of  one  MTA and 'SubstDrive YZ'
  2056.                        for two concurrently running MTA's;
  2057.  
  2058.          There is  nothing to  worry about  when you  use the SubstDrive
  2059.          option  (unless  you  have  a  very special configuration). MTA
  2060.          will do all the work  for you. MTA will assign  the SUBSTituted
  2061.          drives itself (by calling  SUBST.EXE/COM) and will remove  them
  2062.          again when  conversion is  finished. MTA  will check  the drive
  2063.          letters you supplied  in the SubstDrive  to see if  any of them
  2064.          is a 'real' drive. If this  is the case, MTA will abort.  Under
  2065.          special conditions  this test  may fail  though, so  you should
  2066.          take  all  previous  warnings  in  mind before you start. Don't
  2067.          experiment  with  the  option,  just  do  it  the  way  it   is
  2068.          suggested.
  2069.  
  2070.  Relate: SubstOn, SubstOff
  2071.  Dest. : All
  2072.  
  2073.  
  2074.  ┌─────────────────────────────────────────────────────────────────────┐
  2075.  │ SubstOn [path] {parm}..{parm}                                       │
  2076.  └─────────────────────────────────────────────────────────────────────┘
  2077.  Usage : This  option  can  only   be  used  in  combination  with   the
  2078.          SUBSTDrive  option.   When  used,   the  SubstOff   option   is
  2079.          mandatory.
  2080.  
  2081.          When SubstDrive  is set,  MTA will  use the  following calls to
  2082.          the DOS SUBST.EXE  program to set  the substituted drive  ON or
  2083.          OFF:
  2084.  
  2085.          - On
  2086.            [drive:][dir]\SUBST.EXE [drive_to_page] [dir_to_page_over]
  2087.  
  2088.          - Off
  2089.            [drive:][dir]\SUBST.EXE [drive_to_page] /D
  2090.  
  2091.          Normally  this  will  work  in  the  proper way unless you need
  2092.          another syntax (special DOS-versions) or you even need  another
  2093.          program (networks) to  page (virtual) drives  over directories.
  2094.          For this need,  you can use  the SubstOn and  SubstOff options.
  2095.          With  these  options,  you  can  tell MTA which program(s) with
  2096.          which parameters  are to  be called  to switch  the substituded
  2097.          (paged) drive on (SubstOn) and off (SubstOff):
  2098.  
  2099.          [Path]        This parameter must contain the drive,  directory
  2100.                        and  filename  of  the  program  in question. MTA
  2101.                        will  validate  the working of the program;
  2102.  
  2103.          [parm] {parm} At  this  location   you  can  (must) supply  the
  2104.                        various parameters for  the program. There  are a
  2105.                        few macros  available  that  will  be replaced by
  2106.                        values at run-time. These are:
  2107.  
  2108.                        %DP This  macro will  be replaced  with the drive
  2109.                            letter (without  ':') of  drive that  will be
  2110.                            paged over the temporary directory;
  2111.  
  2112.                        %DF This  macro will  be replaced  with the drive
  2113.                            letter  (WITH  ':')  of  drive  that  will be
  2114.                            paged over the temporary directory;
  2115.  
  2116.                        %PP This macro will be replaced by the  temporary
  2117.                            directory  that  needs  to  be  accessed as a
  2118.                            drive  (normally  a  directory  under the one
  2119.                            you  specified  in  MTATempPath).  This macro
  2120.                            will NOT give a directory with a backslash;
  2121.  
  2122.                        %PF This macro will be replaced by the  temporary
  2123.                            directory  that  needs  to  be  accessed as a
  2124.                            drive  (normally  a  directory  under the one
  2125.                            you  specified  in  MTATempPath).  This macro
  2126.                            WILL give a directory with a backslash;
  2127.  
  2128.                        %NP Same as %PP but without the drive-letter (so
  2129.                            you can create combinations like \\TEM\PAS;
  2130.  
  2131.                        %NF Same as %PF but without the drive-letter (so
  2132.                            you can create combinations like \\TEM\PAS\;
  2133.  
  2134.          Included are  two examples,  one that  will be  the same as MTA
  2135.          uses internally (but now  specified with SubstOn and  SubstOff)
  2136.          and one  for a  network that  needs a  program MAP to subtitute
  2137.          (page the drive).  The first example  is split in  two examples
  2138.          (one with  a DIRECT  call to  SUBST and  one using a batch-file
  2139.          SUBST.BAT):
  2140.  
  2141.          - Using SUBST (THIS IS THE MTA DEFAULT AND NEED NOT BE USED)
  2142.            - Directly:
  2143.              SubstOn  C:\DOS\SUBST.EXE %DF %PP
  2144.              SubstOff C:\DOS\SUBST.EXE %DF /D
  2145.            - Called from a batch-file
  2146.              SubstOn  C:\DOS\COMMAND.COM /C C:\DOS\SUB.BAT %DF %PP
  2147.              SubstOff C:\DOS\COMMAND.COM /C C:\DOS\SUB.BAT %DF /D
  2148.  
  2149.          - Using MAP (only an example, use your own Network-program)
  2150.            SubstOn  C:\NOV\MAP.EXE   %DF=\%NP
  2151.            SubstOff C:\NOV\MAP.EXE R %DF
  2152.  
  2153.  Relate: SubstOff, NoSubstTest
  2154.  Dest. : All
  2155.  
  2156.  
  2157.  ┌─────────────────────────────────────────────────────────────────────┐
  2158.  │ SubstOff [path] {parm}..{parm}                                      │
  2159.  └─────────────────────────────────────────────────────────────────────┘
  2160.  Usage : See SubstOn (SubstOff is used tro switch the substitution off).
  2161.  
  2162.  Relate: SubstOn, NoSubstTest
  2163.  Dest. : All
  2164.  
  2165.  
  2166.  ┌─────────────────────────────────────────────────────────────────────┐
  2167.  │ NoSubstTest                                                         │
  2168.  └─────────────────────────────────────────────────────────────────────┘
  2169.  Usage : When  substituted  drives  will be used by MTA (either by using
  2170.          SUBST or  any  other  kind  of  program  when  the  SubstOn and
  2171.          SubstOff  options  are used), MTA will check (after the 'subst'
  2172.          drive is assigned)  if  this  new drive is not a REAL drive. In
  2173.          certain  configurations  (networks), MTA  will get a REAL drive
  2174.          back  and  will  abort. In  these  cases  this option should be
  2175.          supplied. It  will  bypass  the test for a REAL drive ! If this
  2176.          is used  in  a  normal  (non-network)  DOS environment, you are
  2177.          bypassing  all  security  checks  and strange things can happen
  2178.          if the  SUBST-drive  actually IS a real drive with files. Never
  2179.          use this  option  unless  you know what you are doing AND after
  2180.          you have  made  a  backup  of the files on the drive(s) in that
  2181.          can/will be used.
  2182.  
  2183.  
  2184.  Relate: SubstOn, SubstOff, SubstDrive
  2185.  Dest. : All
  2186.  
  2187.  
  2188.  ┌─────────────────────────────────────────────────────────────────────┐
  2189.  │ ExtendedTesting                                                     │
  2190.  └─────────────────────────────────────────────────────────────────────┘
  2191.  Usage : Some older  decompress programs  do not  return an  errorlevel
  2192.          when something is wrong with the decompress. For example,  some
  2193.          older PAK versions (GSARC) could signal that one or more  files
  2194.          inside the archive  contained a CRC-error  but returned a  zero
  2195.          errorlevel. In these cases  MTA will think that  the decompress
  2196.          is ok, will remove the archive and will compress the  remaining
  2197.          (if any) files to a new archive, causing only a part (or  none)
  2198.          of the original archive to be converted.
  2199.  
  2200.          MTA can make  sure (for 98%)  that the extracted  files are the
  2201.          same as the  ones that are  in the original  source-archive. To
  2202.          add this fail-save mechanism, you must add the  ExtendedTesting
  2203.          option in  MTA.CTL. MTA  will count  the combined  uncompressed
  2204.          bytes that the  archive will show  to the world  and will count
  2205.          these bytes again (bases on  the actual files) after the  files
  2206.          are decompressed. If they  differ, MTA will delete  these files
  2207.          again and will move the original archive to the directory  that
  2208.          contains the  faulty archives.  A warning  is produced  and the
  2209.          next conversion (if any) will start.
  2210.  
  2211.          There are some special archives that can not be tested for  the
  2212.          full 100%. These are:
  2213.  
  2214.          - ARJ  archives with  files that  are compressed  as TEXT-files
  2215.            ARJ can compress  files as TEXT-files  (-t1 parameter on  the
  2216.            ARJ  command-line).  The  filesize  of  such files inside the
  2217.            ARJ-archive  is  showed  as  the  size  WITHOUT any CR/LF and
  2218.            CTRL-Z  (EOF)  markers.  For  instance,  a  text-file  with 2
  2219.            records, each containing 10 bytes, will normally have a  size
  2220.            of (2 x 10) + (2 x 2  (CRLF)) + 1 is 25 bytes. ARJ will  show
  2221.            this file as a file with a size of 20. THIS IS ONLY THE  CASE
  2222.            with files that are compressed with -t1 !  If MTA detects  an
  2223.            ARJ-file  with  such  text-files  inside,  it  will  skip the
  2224.            extended  test  (not  to  worry,  because  ARJ will return an
  2225.            errorlevel when  the files  inside the  original archive  are
  2226.            not OK). In a  discussion with the author  of ARJ I was  told
  2227.            that  this  has  something  to  do  with  the multi- platform
  2228.            (DOS/UNIX and so on) support;
  2229.  
  2230.          - ARJ  and ZOO  archives with  backups inside  Both ZOO and ARJ
  2231.            archives  can  contain  backup  copies,  even multiple backup
  2232.            copies. When you make an archive with the file A.A inside  an
  2233.            a  few  days  later  you  will  do  this  again (with special
  2234.            ZOO/ARJ command-line options), the  first A.A will be  marked
  2235.            as backup  and the  second is  added. This  can go  on for  a
  2236.            large number of times, eventually resulting in archives  that
  2237.            contain (for  instance) 100  A.A files,  1 of  them being the
  2238.            original (the one  added last) and  99 backups.   There is NO
  2239.            direct  support  archival  backups  in  MTA  but  you CAN add
  2240.            options in MTA  to instruct ARJ  (and ZOO) to  extract all of
  2241.            these backups  (with a  rename, done  by the  archive program
  2242.            itself). Because  this is  possible, MTA  will skip  extended
  2243.            testing  for  archives  with  backups  inside.  This  is   no
  2244.            problem. ARJ and  ZOO will both  report errorlevels when  the
  2245.            decompress fails;
  2246.  
  2247.          It is advised to always use ExtendedTesting. The only  drawback
  2248.          is some loss in speed but on hard-disks this will be less  than
  2249.          a second for each file (average).
  2250.  
  2251.  Relate: None
  2252.  Dest. : All
  2253.  
  2254.  
  2255.  ┌─────────────────────────────────────────────────────────────────────┐
  2256.  │ ShareWait [seconds]                                                 │
  2257.  └─────────────────────────────────────────────────────────────────────┘
  2258.  Usage : You can  run multiple copies of  MTA AND it is  possible to run
  2259.          MTA in a second task (along side a BBS). In these cases it  can
  2260.          be possible  that MTA  needs resources  (files) that  the other
  2261.          task  is  using  also.  In  multi-tasking environments you must
  2262.          always load SHARE (see DOS manual) to give support to  programs
  2263.          that would  like to  share resources  (files). If  MTA needs  a
  2264.          resource  that  is  currently  locked  (a  file  that  is being
  2265.          updated by the other task), it will wait until the resource  is
  2266.          free again unless it  takes to long. If  it takes to long,  MTA
  2267.          will abort.
  2268.  
  2269.          MTA will look every 10 seconds to see if a resource if free  to
  2270.          use again  (after the  initial lock).  This process  will go on
  2271.          for 300  seconds (5  minutes) by  default. After  that, no  new
  2272.          cycle will  start, but  MTA will  abort. You  can also stop the
  2273.          cycle by pressing CTRL-E, in which case MTA will abort.
  2274.  
  2275.          [seconds]     By default, MTA will  look every 10 seconds   for
  2276.                        the duration of 300  seconds. You can alter  this
  2277.                        value  to  anything  you  like.  If  you  want to
  2278.                        change it, you  must supply the  ShareWait option
  2279.                        with  that  number  of  seconds. F.i., 'ShareWait
  2280.                        600' will cause MTA to look every 10 seconds  for
  2281.                        the duration of 600 seconds (is 10 minutes).
  2282.  
  2283.          ShareWait is ONLY needed in a multitasking/network  environment
  2284.          and has no meaning  when SHARE is not  loaded. If SHARE is  not
  2285.          loaded and a lock  occurs (multi-tasking without sharing),  MTA
  2286.          will abort directly !
  2287.  
  2288.  Relate: None
  2289.  Dest. : All
  2290.  
  2291.  
  2292.  ┌─────────────────────────────────────────────────────────────────────┐
  2293.  │ AltDisplay                                                          │
  2294.  └─────────────────────────────────────────────────────────────────────┘
  2295.  Usage : When running  in a  normal 80x25  text-screen, MTA can  display
  2296.          two different kind of information windows on the right side  of
  2297.          the  screen.  The  normal  one  contains  a summary of the most
  2298.          important options.  The other  one contains  a dynamic  list of
  2299.          the archives  that still  need to  be converted.  You can  swap
  2300.          between the list with  the 'T' key but  you can also force  MTA
  2301.          to display the dynamic file-list  at startup. In that case  you
  2302.          can  still  swap  screens  with  the  'T'  key, but the dynamic
  2303.          window is the first one to show up when you start MTA.
  2304.  
  2305.          To force  MTA to  start with  the dynamic  file-list, you  must
  2306.          supply the AltDisplay option.  When running in 110+x25+  modes,
  2307.          MTA will always display BOTH windows and the AltDisplay  option
  2308.          will be ignored.
  2309.  
  2310.  Relate: None
  2311.  Dest. : All
  2312.  
  2313.  
  2314.  ┌─────────────────────────────────────────────────────────────────────┐
  2315.  │ WarningTime [cycles]                                             (*)│
  2316.  └─────────────────────────────────────────────────────────────────────┘
  2317.  Usage : MTA will sometimes give a  warning or an error. In this case  a
  2318.          message is displayed and a  'running light' is displayed for  a
  2319.          number of  cycles. You  can stop  the cycles  by hitting ESC or
  2320.          you can wait until it is finished (around 20 seconds).
  2321.  
  2322.          [cycles]      By default, MTA  will use 20 cycles   (equivalent
  2323.                        to 20 seconds). You  can supply any value  from 0
  2324.                        (no cycles) to 65535.
  2325.  
  2326.          If you supply a value of  zero, MTA will also stop making  some
  2327.          noise when errors or warnings are displayed. If you supply  any
  2328.          non-zero value,  MTA will  beep when  an error  or a warning is
  2329.          displayed unless the NoBeep option is active.
  2330.  
  2331.  Relate: NoBeep
  2332.  Dest. : All
  2333.  (*)   : Marked options are also in usage by: MTM
  2334.  
  2335.  
  2336.  ┌─────────────────────────────────────────────────────────────────────┐
  2337.  │ NoBeep                                                              │
  2338.  └─────────────────────────────────────────────────────────────────────┘
  2339.  Usage : By default  MTA will produce a  beep on the PC-speaker  when an
  2340.          error or warning is displayed (or when MTA is finished).  There
  2341.          will be no  sound when WarningTIme  equals a value  of zero but
  2342.          in this case you  will also not see  any messages. If you  want
  2343.          to see  messages but  you dislike  the sound,  you must use the
  2344.          NoBeep option in MTA.CTL.
  2345.  
  2346.  Relate: WarningTime
  2347.  Dest. : All
  2348.  
  2349.  
  2350.  
  2351.  3.3.3 Statements that define the logging
  2352.  ───────────────────────────────────────────────────────────────────────
  2353.  MTA can log almost anything.  The following statements define the  type
  2354.  of logging (if any)  for the several actions  and the actual format  of
  2355.  the logged records.
  2356.  
  2357.  ┌─────────────────────────────────────────────────────────────────────┐
  2358.  │ LogPath [dir]                                                       │
  2359.  │ LogPath [path]                                                      │
  2360.  └─────────────────────────────────────────────────────────────────────┘
  2361.  Usage : MTA can log almost everything. Under normal conditions you  can
  2362.          choose not to log (it will  speed things up a little) but  then
  2363.          you will not be able to create statistical reports and  nothing
  2364.          can be traced back. In a BBS environment you can choose to  log
  2365.          in  the  same  log-file  as  the  one  that is used by your BBS
  2366.          program. In all cases  MTA will try to  open the log in  shared
  2367.          append mode, so current logs will appended to and full  sharing
  2368.          is available. There  are two different  ways you can  setup the
  2369.          logging:
  2370.  
  2371.          [dir]         This value must point to a valid  drive/directory
  2372.                        where logging  will take  place. If  no drive  is
  2373.                        supplied,  the  default  one  is  used.  Relative
  2374.                        directories (..\WRKDIR and such) are not  advised
  2375.                        but  can  be  used  (the  are  counted  from  the
  2376.                        CURRENT directory).   In this  case MTA  will try
  2377.                        to open the file  with the name MTA.LOG  and will
  2378.                        append  to  it  when  it  is present or create it
  2379.                        when it is not (yet) available;
  2380.  
  2381.          [path]        This value must point to a valid  drive/directory
  2382.                        and  filename  of  the  log-file.  If no drive is
  2383.                        supplied,  the  default  one  is  used.  Relative
  2384.                        directories (..\WRKDIR and such) are not  advised
  2385.                        but  can  be  used  (the  are  counted  from  the
  2386.                        CURRENT directory).   In this  case MTA  will try
  2387.                        to open the file with the SUPPLIED name and  will
  2388.                        append  to  it  when  it  is present or create it
  2389.                        when it is not (yet) available;
  2390.  
  2391.          The LogPath option only assigns the actual log-file or (if  not
  2392.          present) will force to 'noLog'. The style of logging that  will
  2393.          be used, will depend on other options. Inside the log-file  you
  2394.          will  see  information,  statistics,  warnings  and errors. The
  2395.          earlier MTA versions contained a ErrorLogPath option. With  the
  2396.          15.01 release (and higher) this option has become obsolete.
  2397.  
  2398.  Relate: LogStyleFormat
  2399.  Dest. : All
  2400.  
  2401.  
  2402.  ┌─────────────────────────────────────────────────────────────────────┐
  2403.  │ LogThreshold [bytes]                                                │
  2404.  └─────────────────────────────────────────────────────────────────────┘
  2405.  Usage : This  option  is used by both MTA and MTL. You can set a number
  2406.          of bytes which  will be  the  threshold for both MTA and MTL to
  2407.          do a special function.
  2408.  
  2409.          [bytes]       This must be a numeric (positive) value that will
  2410.                        be used as the threshold;
  2411.  
  2412.          If the  log-file (as defined on the LOGPATH option) gets bigger
  2413.          than [bytes], MTA  will  terminate  with  an errorlevel that is
  2414.          100 bigger  than  normal. Currently  MTA can terminate with the
  2415.          errorlevels  0 (normal termination), 16 (abnormal termination),
  2416.          100 (normal  termination and LOG-file is bigger than [bytes] or
  2417.          116 (abnormal termination and LOG-file is bigger that [bytes]).
  2418.  
  2419.          MTL will  use  the  LogThreshold  option  to  detect if the log
  2420.          has to  be  compressed  (when MTL  is executed with /BATCH) and
  2421.          will  (or will not)  compress  the  log according to the actual
  2422.          size.
  2423.  
  2424.          MTA can  work  with  errorlevel  for this function, to overcome
  2425.          a useless call to MTL.
  2426.  
  2427.          You can setup  a  batch  where  you can test the errorlevel and
  2428.          call MTL when the errorlevel is 100 or 116.
  2429.  
  2430.  Relate: LogPath and MTL
  2431.  Dest. : All
  2432.  
  2433.  
  2434.  ┌─────────────────────────────────────────────────────────────────────┐
  2435.  │ AVLogPath [dir]                                                     │
  2436.  │ AVLogPath [path]                                                    │
  2437.  └─────────────────────────────────────────────────────────────────────┘
  2438.  Usage : MTA can log AV-codes and names. Under normal conditions you can
  2439.          choose not to log (it will  speed things up a little) but  then
  2440.          you will  not  be  able  to  see which AV-codes belong to which
  2441.          authors. This  log-file  will  contain AV-numbers (from ZIP and
  2442.          ARJ files) and  the  names that belong to that numbers. The log
  2443.          can be a help when you setup the IncludeAVFile option(s). Never
  2444.          point  to  the  same  log as in the LogPath option. The general
  2445.          format  of  the  AV-log  is quite different than the normal log
  2446.          that MTA maintains !
  2447.          There are two different ways you can setup the logging:
  2448.  
  2449.          [dir]         This value must point to a valid  drive/directory
  2450.                        where logging  will take  place. If  no drive  is
  2451.                        supplied,  the  default  one  is  used.  Relative
  2452.                        directories (..\WRKDIR and such) are not  advised
  2453.                        but  can  be  used  (the  are  counted  from  the
  2454.                        CURRENT directory).   In this  case MTA  will try
  2455.                        to open the file  with the name MTA.LOG  and will
  2456.                        append  to  it  when  it  is present or create it
  2457.                        when it is not (yet) available;
  2458.  
  2459.          [path]        This value must point to a valid  drive/directory
  2460.                        and  filename  of  the  log-file.  If no drive is
  2461.                        supplied,  the  default  one  is  used.  Relative
  2462.                        directories (..\WRKDIR and such) are not  advised
  2463.                        but  can  be  used  (the  are  counted  from  the
  2464.                        CURRENT directory).   In this  case MTA  will try
  2465.                        to open the file with the SUPPLIED name and  will
  2466.                        append  to  it  when  it  is present or create it
  2467.                        when it is not (yet) available;
  2468.  
  2469.  Relate: None
  2470.  Dest. : All
  2471.  
  2472.  
  2473.  ┌─────────────────────────────────────────────────────────────────────┐
  2474.  │ NormalPasswordListPath [dir]                                        │
  2475.  │ NormalPasswordListPath [path]                                       │
  2476.  └─────────────────────────────────────────────────────────────────────┘
  2477.  Usage : When  you   create  archives  with passwords  (/OP command-line
  2478.          parameter), MTA will  log these archives  (and passwords) in  a
  2479.          special  log-file.  This  log-file  CAN  be  the  same  as  the
  2480.          log-file that is assigned in the LogPath option or it can be  a
  2481.          different  log.  The  usage  of NormalPasswordListPath is fully
  2482.          optional but if you leave it out and you use passwords for  the
  2483.          target  archives  you  must  remember  the  passwords from your
  2484.          head.
  2485.  
  2486.          [dir]         This value must point to a valid  drive/directory
  2487.                        where logging  will take  place. If  no drive  is
  2488.                        supplied,  the  default  one  is  used.  Relative
  2489.                        directories (..\WRKDIR and such) are not  advised
  2490.                        but  can  be  used  (the  are  counted  from  the
  2491.                        CURRENT directory).   In this  case MTA  will try
  2492.                        to open the file  with the name MTA.NPW  and will
  2493.                        append  to  it  when  it  is present or create it
  2494.                        when it is not (yet) available;
  2495.  
  2496.          [path]        This value must point to a valid  drive/directory
  2497.                        and  filename  of  the  log-file.  If no drive is
  2498.                        supplied,  the  default  one  is  used.  Relative
  2499.                        directories (..\WRKDIR and such) are not  advised
  2500.                        but  can  be  used  (the  are  counted  from  the
  2501.                        CURRENT directory).   In this  case MTA  will try
  2502.                        to open the file with the SUPPLIED name and  will
  2503.                        append  to  it  when  it  is present or create it
  2504.                        when it is not (yet) available;
  2505.  
  2506.  Relate: RandomPasswordListPath, LogStyleFormat
  2507.  Dest. : All
  2508.  
  2509.  
  2510.  ┌─────────────────────────────────────────────────────────────────────┐
  2511.  │ RandomPasswordListPath [dir]                                        │
  2512.  │ RandomPasswordListPath [path]                                       │
  2513.  └─────────────────────────────────────────────────────────────────────┘
  2514.  Usage : MTA has  an option  to assign  RANDOM passwords  to the  target
  2515.          archives (the /OP@ command-line parameter). The files that  are
  2516.          converted and  the passwords  that have  been assigned  to each
  2517.          file MUST be logged. If you  leave out this option and you  use
  2518.          /OP@, MTA will  ENFORCE the logging  in the current  directory,
  2519.          otherwise  it  uses  the  values  that  are  supplied with this
  2520.          option.
  2521.  
  2522.          [dir]         This value must point to a valid  drive/directory
  2523.                        where logging  will take  place. If  no drive  is
  2524.                        supplied,  the  default  one  is  used.  Relative
  2525.                        directories (..\WRKDIR and such) are not  advised
  2526.                        but  can  be  used  (the  are  counted  from  the
  2527.                        CURRENT directory).   In this  case MTA  will try
  2528.                        to open the file  with the name MTA.PWD  and will
  2529.                        append  to  it  when  it  is present or create it
  2530.                        when it is not (yet) available;
  2531.  
  2532.          [path]        This value must point to a valid  drive/directory
  2533.                        and  filename  of  the  log-file.  If no drive is
  2534.                        supplied,  the  default  one  is  used.  Relative
  2535.                        directories (..\WRKDIR and such) are not  advised
  2536.                        but  can  be  used  (the  are  counted  from  the
  2537.                        CURRENT directory).   In this  case MTA  will try
  2538.                        to open the file with the SUPPLIED name and  will
  2539.                        append  to  it  when  it  is present or create it
  2540.                        when it is not (yet) available;
  2541.  
  2542.  Relate: NormalPasswordListPath, LogStyleFormat
  2543.  Dest. : All
  2544.  
  2545.  
  2546.  ┌─────────────────────────────────────────────────────────────────────┐
  2547.  │ LogStyleFormat [styleformat]                                        │
  2548.  └─────────────────────────────────────────────────────────────────────┘
  2549.  Usage : MTA creates  several log-records  under different   conditions.
  2550.          You  can  use  the  standard  log,  but  Sysop's hate all these
  2551.          different log-files  (in general).   MTA can  create customized
  2552.          log-records. With this option,  you can instruct MTA  to create
  2553.          records that  look the  same as  the records  from your  mailer
  2554.          and/or  BBS  program.    The  option  LogStyleFormat  and   the
  2555.          following LogDateFormat/LogTimeFormat  combination can  be used
  2556.          to define  the style  of the  log-records that  MTA will create
  2557.          for  ALL  three   log-files  (LogPath,   NormalPasswordListPath
  2558.          RandomPasswordListPath   log-files).     These   options    are
  2559.          implemented with the idea  that different log-styles only  vary
  2560.          at the start of the records and NOT at the end.
  2561.  
  2562.          The LogStyleFormat  defines the  'structure' of  the log-record
  2563.          header. The format is free but with three special cases:
  2564.  
  2565.          - Spaces must be replaced by underscore characters '_';
  2566.  
  2567.          - The  part  of  the  record  that  contains  the date must  be
  2568.            defined with %D (if a date is wanted);
  2569.  
  2570.          - The  part  of  the  record  that  contains  the time must  be
  2571.            defined with %T (if a time is wanted);
  2572.  
  2573.          - Any  extra CRLF  combinations (to  create a  separation line)
  2574.            must be defined with ^M;
  2575.  
  2576.          [styleformat] This  is  the  actual  string  that  defines  the
  2577.                        format of the log-header. You can use two  macros
  2578.                        inside this string, the %T that will be  replaced
  2579.                        with the time  in the format  as supplied in  the
  2580.                        LogTimeFormat  option   and  %D   that  will   be
  2581.                        replaced with the date in the format as  supplied
  2582.                        in  the  LogDateFormat  option.  You must observe
  2583.                        the 4 rules that are described above;
  2584.  
  2585.          An example  (also read  LogDateFormat and  LogTimeFormat for  a
  2586.          description  of  the  time  and  date  functions).  You want to
  2587.          create records that look like this:
  2588.  
  2589.          +  6 Jan 1990   2:00p   The-start-of-the-log
  2590.  
  2591.          The 'The-start-of-the-log' part  is constructed by  MTA itself,
  2592.          so  you  have  only  to  define  the  header.  This  is done as
  2593.          follows:
  2594.  
  2595.          LogStyleFormat +_%D__%T___       (The '_' replaces the spaces)
  2596.          LogDateFormat  DD_nnn_yyyy
  2597.          LogTimeFormat  HH:mmt
  2598.  
  2599.          %D and %T are  replaced by MTA with  the date and time  formats
  2600.          as  supplied  in   LogDateFormat  and  LogTimeFormat.   MTA.CTL
  2601.          contains  a  number  of  examples  for  the  various BBS/Mailer
  2602.          programs.
  2603.  
  2604.  Relate: LogStartStyleFormat, LogDateFormat, LogTimeFormat
  2605.  Dest. : All
  2606.  
  2607.  
  2608.  ┌─────────────────────────────────────────────────────────────────────┐
  2609.  │ LogStartStyleFormat [styleformat]                                   │
  2610.  └─────────────────────────────────────────────────────────────────────┘
  2611.  Usage : This   is  an   additional    option  you   can use along  with
  2612.          the previous   LogStyleFormat  option.   Some  types   of   log
  2613.          use  a special  format  where   the  actual  date  is put  into
  2614.          an extra record  (with- out any   further meaning than  logging
  2615.          the date).   MTA can create  such a record   for you. MTA  will
  2616.          put   the     record   with   the   format   you   supply    in
  2617.          LogStartStyleFormat into the  log as the first and only  record
  2618.          for THIS run of MTA. If MTA  stops and is started again, a  new
  2619.          record of this type is written.
  2620.  
  2621.          [styleformat] This  is  the  actual  string  that  defines  the
  2622.                        format of  the log-file  start. You  can use  two
  2623.                        macros inside  this string,  the %T  that will be
  2624.                        replaced with the time in the format as  supplied
  2625.                        in the LogTimeFormat option  and %D that will  be
  2626.                        replaced with the date in the format as  supplied
  2627.                        in  the  LogDateFormat  option.  You must observe
  2628.                        the 4 rules that are described above;
  2629.  
  2630.          A type of log with this  format is found in the FrontDoor  <tm>
  2631.          mailer. The  options you  can use  in this  logstyle-format are
  2632.          the same as with the LogStyleFormat option.
  2633.  
  2634.  Relate: LogStyleFormat, LogDateFormat, LogTimeFormat
  2635.  Dest. : All
  2636.  
  2637.  
  2638.  ┌─────────────────────────────────────────────────────────────────────┐
  2639.  │ LogDateFormat [styleformat]                                         │
  2640.  └─────────────────────────────────────────────────────────────────────┘
  2641.  Usage : LogDateFormat is used to define the 'date part' (actually the
  2642.          %D) in the LogStyleFormat option. MTA can is able to replace a
  2643.          number of characters (macros) by parts that make up the date.
  2644.          You can (must) also include special date-separation characters
  2645.          so your newly created date will actually look like a data !
  2646.  
  2647.          [styleformat] This is the actual string that defines the
  2648.                        format of the %D macros, used in the options
  2649.                        LogStyleFormat and LogStartStyleFormat. The
  2650.                        [styleformat] must be coded in the format you
  2651.                        want the date to have. Spaces, used as the
  2652.                        separation between components of the date, must
  2653.                        be coded as spaces (and not as '_' characters).
  2654.                        The following codes can be used:
  2655.  
  2656.                        mm    Month with a (optionally) leading zero
  2657.  
  2658.                        MM    Month  ,,         ,,         ,,   space
  2659.  
  2660.                        dd    Day    ,,         ,,         ,,   zero
  2661.  
  2662.                        DD    Day    ,,         ,,         ,,   space
  2663.  
  2664.                        yy    Year  (format: 92  )
  2665.  
  2666.                        yyyy  Year  (format: 1992)
  2667.  
  2668.                        nnn   Name of the  month (with mixed  case,  like
  2669.                              Jan, Oct  and so  on). The  length of 'nnn'
  2670.                              will  rule  the  length  of  the  name,  so
  2671.                              'nnnn' will be replaced by 'Janu';
  2672.  
  2673.                        NNN   Name of  the month  (UPPER case,  like  JAN
  2674.                              OCT and  so on).  The length  of 'nnn' will
  2675.                              rule  the  length  of  the  name, so 'NNNN'
  2676.                              will be replaced by 'JANU';
  2677.  
  2678.                        www   Name of  the day  (with mixed  case,   like
  2679.                              Fri, Sat  and so  on). The  length of 'www'
  2680.                              will  rule  the  length  of  the  name,  so
  2681.                              'wwww' will be replaced by 'Frid';
  2682.  
  2683.                        WWW   Name of  the month  (UPPER case,  like  FRI
  2684.                              SAT and  so on).  The length  of 'nnn' will
  2685.                              rule  the  length  of  the  name, so 'WWWW'
  2686.                              will be replaced by 'FRID';
  2687.  
  2688.          Some valid examples (notice the separation characters that  are
  2689.          coded between the macros):
  2690.  
  2691.          mm/dd/yy         01/31/90
  2692.          MM-dd-yy          1-31-90
  2693.          dd/mm/yyyy       31/01/1990
  2694.          dd/mm/yyyy       31/01/1990
  2695.          dd NNN yyyy      31 JAN 1990
  2696.          dd nnn yy        31 Jan 1990
  2697.          dd n yyyy        31 J 1990
  2698.          www dd nnn yyyy  Sun 31 Jan 1990
  2699.  
  2700.  Relate: LogStyleFormat, LogStartStyleFormat
  2701.  Dest. : All
  2702.  
  2703.  
  2704.  ┌─────────────────────────────────────────────────────────────────────┐
  2705.  │ LogTimeFormat [styleformat]                                         │
  2706.  └─────────────────────────────────────────────────────────────────────┘
  2707.  Usage : LogTimeFormat is used  to define the 'time part'  (actually the
  2708.          %T) in the LogStyleFormat option. MTA can is able to replace  a
  2709.          number of characters (macros) by  parts that make up the  time.
  2710.          You can (must) also include special time-separation  characters
  2711.          so your newly created time will actually look like a time !
  2712.  
  2713.          [styleformat]  This  is  the  actual  string  that  defines the
  2714.                        format  of  the  %T  macros,  used in the options
  2715.                        LogStyleFormat   and   LogStartStyleFormat.   The
  2716.                        [styleformat]  must  be  coded  in the format you
  2717.                        want  the  time  to  have.  Spaces,  used  as the
  2718.                        separation between components  of the time,  must
  2719.                        be coded as spaces  (and not as '_'  characters).
  2720.                        The following codes can be used:
  2721.  
  2722.                        hh    Hour  with a (optionally) leading zero
  2723.  
  2724.                        HH    Hour   ,,         ,,         ,,   space
  2725.  
  2726.                        mm    Min    ,,         ,,         ,,   zero
  2727.  
  2728.                        MM    Min    ,,         ,,         ,,   space
  2729.  
  2730.                        ss    Sec    ,,         ,,         ,,   zero
  2731.  
  2732.                        SS    Sec    ,,         ,,         ,,   zero
  2733.  
  2734.                        t     will be replaced by 'p' (in pm) or 'a'  (in
  2735.                              am);
  2736.  
  2737.                        T     will be replaced by 'P' (in PM) or 'A'  (in
  2738.                              AM);
  2739.  
  2740.                        e     will be  replaced with 'm'  (in am or   pm)
  2741.                              and must be combined with 'T' or 't';
  2742.  
  2743.                        E     will be  replaced with 'M'  (in AM or   PM)
  2744.                              and must be combined with 'T' or 't';
  2745.  
  2746.                        If   you    leave   out    any    't'/'T'/'e'/'E'
  2747.                        combination, the time will be in 24-hour format.
  2748.  
  2749.          Some  valid  examples  (notice  the  separation characters that
  2750.          are coded between the macros):
  2751.  
  2752.          hh:mm            14:00
  2753.          hh.mmt           02.00p
  2754.          HH:mmte           2:00pm
  2755.          HH:mm:ss         14:00:45
  2756.          hh:mm:ss         14:00:45
  2757.  
  2758.  Relate: LogStyleFormat, LogStartStyleFormat
  2759.  Dest. : All
  2760.  
  2761.  
  2762.  
  2763.  3.3.4 Statements that define the selection of files
  2764.  ───────────────────────────────────────────────────────────────────────
  2765.  There are several options in MTA.CTL that rule the selection of  files.
  2766.  Most of  them are  described in  this chapter.  Those which  have to do
  2767.  with  the  selection  of  files  in  a BBS environment (SysOp's) can be
  2768.  found in the chapter that describes the special BBS parameters.
  2769.  
  2770.  ┌─────────────────────────────────────────────────────────────────────┐
  2771.  │ DefaultPath [dir] {targetdir}                                       │
  2772.  └─────────────────────────────────────────────────────────────────────┘
  2773.  Usage : Without any  special options,  MTA will  start working  in  the
  2774.          current directory. There are several ways to overrule this  (by
  2775.          default in MTA.CTL or temporary  on the command-line).  One  of
  2776.          the  options  that  can  be  used  by both BBS operators and by
  2777.          normal users, is this DefaultPath option. With this option  you
  2778.          force MTA  to convert  files that  are in  the directories that
  2779.          you supply on one or more (up to 255) DefaultPath options.
  2780.  
  2781.          If you  don't do  special actions  AND you  leave the converted
  2782.          files inside  the directories  that you  assign with  the FIRST
  2783.          parameter of this option, MTA will convert them AGAIN when  you
  2784.          start MTA for the second  (and further) time. You can  fix this
  2785.          problem  by  either  marking  the   files  as  done  (see   the
  2786.          MarkString  related  options)  or  by  using  the  OnlyNewFiles
  2787.          option  or  by  moving  them  to  another directory that is not
  2788.          touched by MTA, either automatically or by hand.
  2789.  
  2790.          The selection of  which files inside  these directories are  to
  2791.          be converted is  ruled by the  file-mask(s) that you  supply on
  2792.          the command-line.
  2793.  
  2794.          [dir]         This value must point to a valid  drive/directory
  2795.                        where conversion will take place. If no drive  is
  2796.                        supplied,  the  default  one  is  used.  Relative
  2797.                        directories (..\WRKDIR and such) are not  advised
  2798.                        but  can  be  used  (the  are  counted  from  the
  2799.                        CURRENT directory).
  2800.  
  2801.          {targetdir}   This value  CAN point to a valid  drive/directory
  2802.                        where  files  that  are  converted  in  [dir] are
  2803.                        moved to AFTER the conversion. If no  {targetdir}
  2804.                        is   supplied,   the   files   stay   in   [dir].
  2805.                        Relative  directories  (..\WRKDIR  and  such) are
  2806.                        not  advised  but  can  be  used (the are counted
  2807.                        from the  CURRENT directory).  This parameter  is
  2808.                        optional !!
  2809.  
  2810.          There can  be up  to 255  DefaultPath options.  You can mix the
  2811.          formats (some  of them  can have  a {targetdir},  some of  them
  2812.          don't have this parameter).
  2813.  
  2814.          If  you  use  the  /W  command-line  parameter, the DefaultPath
  2815.          options are ignored ! If  you use the full-screen selection  of
  2816.          files (MTA is  started without any  file-mask), ONLY the  first
  2817.          directory is  converted and  all other  DefaultPath options are
  2818.          ignored !
  2819.  
  2820.  Relate: BBSPaths BBS systems
  2821.  Dest. : All
  2822.  
  2823.  
  2824.  ┌─────────────────────────────────────────────────────────────────────┐
  2825.  │ DoNot [filemask]                                                    │
  2826.  │ DoNot [path]                                                        │
  2827.  └─────────────────────────────────────────────────────────────────────┘
  2828.  Usage : When   you   use     MTA      unattended   or   you     convert
  2829.          complete directories   (with  f.i.   DefaultPath  options)   it
  2830.          is possible  that   files   are   converted   that   you  don't
  2831.          want to convert.  Examples of  these files  are many  but  most
  2832.          commonly, you can think of files that  came from programs  like
  2833.          XRS (734B0384.TU1 and such) or  files that have a public  usage
  2834.          (like  NODEDIFF.A23 and such).
  2835.  
  2836.          The DoNot option  can be used  to exclude some  files EVEN when
  2837.          they match  the file-mask  selection on  the command-line.  You
  2838.          can use up to 255 of EACH these options (so 255 with [path] AND
  2839.          255 with [filemask]).
  2840.  
  2841.          [path]        This parameter must contain a complete path with
  2842.                        filemask,  so drive, directory and filemask like
  2843.                        in E:\ZIP\*.A??.  Wildcards  in the filemask can
  2844.                        be used (see below);
  2845.  
  2846.          [filemask]    The parameter must  contain a single   file-mask.
  2847.                        You  can  use  the  normal  DOS  wildcards (?,*).
  2848.                        Also  a  special  wildcard  (=)  can be used. '='
  2849.                        will test  for a  shifting match.  So '=WAR' will
  2850.                        match  tradeWAR.zip  and  also  WARning.ARC.  =FZ
  2851.                        will NOT  match with  nodedifF.Zip. In  this case
  2852.                        you  must  use  =F.Z;
  2853.  
  2854.          When using the /D and AllDisketteFiles options together,  files
  2855.          are NEVER excluded.  This is also  the case when  MTA does call
  2856.          to itself (compressed-in-compressed files).
  2857.  
  2858.  Relate: None
  2859.  Dest. : All
  2860.  
  2861.  
  2862.  ┌─────────────────────────────────────────────────────────────────────┐
  2863.  │ SFXFiles                                                            │
  2864.  └─────────────────────────────────────────────────────────────────────┘
  2865.  Usage : With  archive conversion you  have to deal  with so called  SFX
  2866.          files. These  are SelF  eXtracting archives.  In general,  this
  2867.          are normal COM or  EXE files that can  be started as a  program
  2868.          and which task  only is to  decompress all files  that are also
  2869.          inside  this  COM/EXE  file.  SFX  files  are commonly used for
  2870.          distribution of  the archive  programs them  self. It  would be
  2871.          rather  difficult  to  decompress  PKZ110.ZIP  if  this was the
  2872.          first time you got  involved with ZIP, so  such a file will  be
  2873.          distributed as PKZ110.EXE.
  2874.  
  2875.          MTA is able to convert SFX files into a new target system.   To
  2876.          do so, it must be able to recognize such a file as an  archive.
  2877.          These is a lot of coding involved  in MTA to do so and I  won't
  2878.          say that the coding  can trap 100% of  each cases.  Most  other
  2879.          products that  involve archives  will tell  you that  they will
  2880.          recognize SFX  files for  100% but  most of  them will  fail on
  2881.          occasion. A SFX archive contains some executable coding at  the
  2882.          start of the archive.  MTA must be able  (and is) to skip  this
  2883.          coding  and  to  look  for  the  archive  part.  To keep MTA as
  2884.          'generic' as possible, there is no SPECIFIC code for each  type
  2885.          of header.  This would  make maintenance  almost an  impossible
  2886.          job because the headers change with every new version of  every
  2887.          archive that supports  SFX archives. Up  to now, MTA  has never
  2888.          failed its  job BUT  it is  possible that  MTA will recognize a
  2889.          normal  EXE/COM  file  as  being  a  SFX  file.   This is not a
  2890.          problem because the decompression of such a file will fail  and
  2891.          the file will stay as it is.
  2892.  
  2893.          Normally MTA  will NOT  (by default)  convert SFX  archives. If
  2894.          you  supply  this  option,  MTA  will also start converting SFX
  2895.          files  if  they  match  the  file-masks  that you supply on the
  2896.          command-line.
  2897.  
  2898.  Relate: None
  2899.  Dest. : All
  2900.  
  2901.  
  2902.  ┌─────────────────────────────────────────────────────────────────────┐
  2903.  │ MaxGifDim [w] [h] [c]                                               │
  2904.  └─────────────────────────────────────────────────────────────────────┘
  2905.  Usage : This  option  rules   the  selection  of GIF files. It  is only
  2906.          needed when you  run the unregistered  version of GIFLITE  <tm>
  2907.          but  will  also  work  for  GIF  to JPEG conversions. With this
  2908.          option you instruct MTA only to select GIF files that have  the
  2909.          same or a  lower resolution. The  option is ignored  when using
  2910.          GIF as  the compression  type (GIFTEST).  For this  conversion,
  2911.          you   can   add   a   command-line   parameter   for    GIFTEST
  2912.          (GTECompression option) in which  case GIFTEST will reject  all
  2913.          GIF files with dimensions LOWER than a specific one.
  2914.  
  2915.          [w] [h] [c]   With this  3 parameters you  define the   maximum
  2916.                        resolution of  GIF files  what will  be selected.
  2917.                        The values 640  480 256 will  be useful when  you
  2918.                        use the  unregistered version  of GIFLITE,  other
  2919.                        values can be set to narrow the selection.
  2920.  
  2921.          Please notice that  the three parameters  have an OR  relation.
  2922.          If one of them is smaller  than the actual resolution of a  GIF
  2923.          file, the  file is  not selected.  So a  641*479*255 GIF is NOT
  2924.          selected when  the option  is set  to 640  480 256  because the
  2925.          weight (641) is higher than 640.
  2926.  
  2927.  Relate : GIFLite
  2928.  Dest   : GIF types
  2929.  
  2930.  
  2931.  ┌─────────────────────────────────────────────────────────────────────┐
  2932.  │ NoMarked                                                            │
  2933.  └─────────────────────────────────────────────────────────────────────┘
  2934.  Usage : What if you have one or more directories that contain  archives
  2935.          and where you want to  convert ONLY archives that haven't  been
  2936.          converted before ? So a directory contains 20 ZIP archives  and
  2937.          each period, you move 1  or more new archives (ALSO  containing
  2938.          ZIP archives amongst others)  to this directory. You  only want
  2939.          to convert  these 1  or more  archives once,  without having to
  2940.          convert the other 20. This is  a normal problem on a BBS  where
  2941.          various archives are stored  in the upload-space and  the Sysop
  2942.          only wants to convert the newly uploaded archives.
  2943.  
  2944.          There are two  ways to do  it. One is  to use the  OnlyNewFiles
  2945.          option (see  later), but  this is  a very  primitive (but fast)
  2946.          way. The other is to use MTA's Archive Marking System <tm>.
  2947.  
  2948.          When AMS is active, MTA  will convert an archive and  after the
  2949.          conversion is finished,  MTA will add  a special string  at the
  2950.          end of the  archive. This string  is made up  with some special
  2951.          information that will be unique. When MTA runs again, the  file
  2952.          is read and MTA will detect that this string is present. If  it
  2953.          is, MTA will ignore the archive (unless AMS is switched off).
  2954.  
  2955.          If, for  some reason,  you want  to remove  the special string,
  2956.          you can run MTM (a support  utility in this package) to do  so.
  2957.          Also, when  you want  to start  using AMS  and you already have
  2958.          many converted  archives, you  can use  MTM to  add the  string
  2959.          (called the mark-string) to all these files, without having  to
  2960.          convert them.
  2961.  
  2962.          AMS will  be active  when NoMarked  is set  to on.  This option
  2963.          will instruct MTA to look if an archive contains a  mark-string
  2964.          and if so, if  it is the one  that you use on  your system. The
  2965.          mark-string can be created (and made unique) by yourself !
  2966.  
  2967.          All compressors  have been  tested with  this extra information
  2968.          appended and they seem to have no trouble with it. That is  not
  2969.          so strange if you  know that some communication  protocols will
  2970.          append binary  zeroes to  a file,  when transferred,  to fill a
  2971.          complete transfer block.
  2972.  
  2973.          A special word about  the mark-string information. If  everyone
  2974.          should use MTA's default and should download a file,  converted
  2975.          with MTA/NoMarked  and would  like to  convert this  file again
  2976.          with MTA/NoMarked, the file would be ignored. It is advised  to
  2977.          set your  own marker  with the  MarkString option  to something
  2978.          more or  less private.  BBS's could  enter their Node/Net/Point
  2979.          number or the name of the SysOp or something like  Ghostbuster,
  2980.          Snoopy or whatsoever.
  2981.  
  2982.          Another piece of advise. Many  BBS Sysop's like to convert  all
  2983.          files in the  upload-space to see  if there is  a virus inside.
  2984.          MTA is  perfect to  do that  job BUT  you must  be careful with
  2985.          your mark-string. If users can download archives from you  that
  2986.          contain the mark-string, they are able to upload archives  with
  2987.          a virus AND YOUR mark-string also. When this file is placed  in
  2988.          the upload-directory and you use the NoMarked option, MTA  will
  2989.          ignore the  archive because  it already  contains your mark-ID.
  2990.          You can use one of the following scenarios:
  2991.  
  2992.          - Use the  mark-string in the  upload directory conversion  but
  2993.            remove the  string (with  MTM) before  the file  is available
  2994.            for download (when moved to its own directory);
  2995.  
  2996.          - Don't use  the mark-string in  your upload-directory but  use
  2997.            it only in your normal directories;
  2998.  
  2999.          - Don't use the  mark-string in your upload-directory  (run MTM
  3000.            to remove any),  then convert the  file with NoMark  and move
  3001.            it at once to another directory. When MTA is used as an  exit
  3002.            to the  protocol-driver in  your BBS  (you can  use FileDoor,
  3003.            another DISP product, to do so), you can set up marking in  a
  3004.            save way  (convert ALL  archives that  are uploaded  and only
  3005.            convert  archives  that  are   not  marked  in  your   upload
  3006.            directory);
  3007.  
  3008.          NoMarked  has  no  meaning  when  using  /D  with  the AllFiles
  3009.          option.  The mark is not set when the MoveToDir option (/M)  is
  3010.          used.
  3011.  
  3012.  Relate: MoveToDir, /D, MarkString
  3013.  Dest. : All
  3014.  
  3015.  
  3016.  ┌─────────────────────────────────────────────────────────────────────┐
  3017.  │ MarkHeader [markstring]                                          (*)│
  3018.  └─────────────────────────────────────────────────────────────────────┘
  3019.  Usage : The  mark-string that is  used by MTA  to test if  archives are
  3020.          already converted and which is  added to new archives when  the
  3021.          NoMarked option is set, is made up of two parts, the so  called
  3022.          header and  the actual  string). Both  have a  default but when
  3023.          you work with  the NoMarked option,  you should AT  LEAST alter
  3024.          the value of the  string and you COULD  alter the value of  the
  3025.          header also. If you  don't alter one or  both of them, it  will
  3026.          be  possible  that  someone  else  supplies an archive with the
  3027.          same values as  you use (because  they didn't alter  the header
  3028.          also).
  3029.  
  3030.          [markstring]  This must  be a  6 byte  long value  you want  to
  3031.                        assign to the  header. The default  is 3 times  a
  3032.                        binary zero and the  upper-case word MTA. If  you
  3033.                        supply less  than 6  bytes, the  header is filled
  3034.                        up to 6 bytes with spaces.
  3035.  
  3036.          If, for  some reason,  you change  [markstring] after  you have
  3037.          converted one  or more  archives with  the older  [markstring],
  3038.          you must run  MTM to convert  [markstring] to the  new value in
  3039.          those archives that have the old value.
  3040.  
  3041.  Relate: NoMarked, MarkString
  3042.  Dest. : All
  3043.  (*)   : Marked options are also in usage by: MTM
  3044.  
  3045.  
  3046.  ┌─────────────────────────────────────────────────────────────────────┐
  3047.  │ MarkString [string]                                              (*)│
  3048.  └─────────────────────────────────────────────────────────────────────┘
  3049.  Usage : The  mark-string that is  used by MTA  to test if  archives are
  3050.          already converted and which is  added to new archives when  the
  3051.          NoMarked option is set, is made up of two parts, the so  called
  3052.          header and  the actual  string). Both  have a  default but when
  3053.          you work with  the NoMarked option,  you should AT  LEAST alter
  3054.          the value of the  string and you COULD  alter the value of  the
  3055.          header also. If you  don't alter one or  both of them, it  will
  3056.          be  possible  that  someone  else  supplies an archive with the
  3057.          same values as  you use (because  they didn't alter  the header
  3058.          also).
  3059.  
  3060.          [markstring]  This  must be a  14 byte long  value you want  to
  3061.                        assign to the string.  The default has the  value
  3062.                        'MTAYour ID here !'.  If you supply less  than 14
  3063.                        bytes, the string is  filled up to 14  bytes with
  3064.                        spaces.
  3065.  
  3066.          If, for  some reason,  you change  [markstring] after  you have
  3067.          converted one  or more  archives with  the older  [markstring],
  3068.          you must run  MTM to convert  [markstring] to the  new value in
  3069.          those archives that have the old value.
  3070.  
  3071.  Relate: NoMarked, MarkString
  3072.  Dest. : All
  3073.  (*)   : Marked options are also in usage by: MTM
  3074.  
  3075.  
  3076.  ┌─────────────────────────────────────────────────────────────────────┐
  3077.  │ UnMark                                                              │
  3078.  └─────────────────────────────────────────────────────────────────────┘
  3079.  Usage : Unmark  overrules  the   NoMark  option and should not be  used
  3080.          together with it. The option  is there for those special  cases
  3081.          where  an  archiver  is  not  able  to decompress a file with a
  3082.          mark-string at  the end.  The earlier  (older) LHA.EXE programs
  3083.          (2.0x series, the 2.1x series  work ok), would fail with  a CRC
  3084.          check when the  file was longer  than the length  calculated by
  3085.          LHA itself. This foolish option  is removed from LHA and  there
  3086.          is no current usage for the option.
  3087.  
  3088.  Relate: NoMarked, MarkHeader
  3089.  Dest. : All
  3090.  
  3091.  
  3092.  ┌─────────────────────────────────────────────────────────────────────┐
  3093.  │ ExcludeFriendlyMark [markmask]                                      │
  3094.  └─────────────────────────────────────────────────────────────────────┘
  3095.  Usage : When your receive  files from a known BBS and that BBS has done
  3096.          everthing  to  the archive  that you would normally do yourself
  3097.          (the correct  virus-scanners,  the correct target format and so
  3098.          on), you could  select to skip conversion of such files because
  3099.          you are doing the same as the BBS has already done for you !
  3100.  
  3101.          With  the  ExcludeFriendlyMark (up  to  10 of these options are
  3102.          allowed), you can instruct MTA which files (in combination with
  3103.          those files that  already  carry your own mark) can be skipped.
  3104.          The only thing  that you must know, is the mark-string that the
  3105.          BBS uses (the BBS must use marking to make this option work).
  3106.  
  3107.          [markmask]    This  must be a  20 byte long  value you want  to
  3108.                        use as the mask. Depending on the values that the
  3109.                        BBS uses  (there  can be non-printable characters
  3110.                        in use, when  the  MTA-default  is used), you can
  3111.                        use the  '?'  wildcard on one or more placed. You
  3112.                        can NOT  include  spaces in the mask ! Spaces can
  3113.                        be replaced with a wildcard ('?');
  3114.  
  3115.          An example:
  3116.  
  3117.          ExcludeFriendlyMark ??????Rob?van.Hoeven
  3118.  
  3119.          The first  6 characters  are  masked  because  they are the MTA
  3120.          default X'00'  (6 times)  and  not  printable  characters.  The
  3121.          space  between  'Rob' and 'van.Hoeven'  is  also masked because
  3122.          there are no spaces allowed in the ExcludeFriendlyMark option.
  3123.  
  3124.  Relate: NoMarked, MarkHeader
  3125.  Dest. : All
  3126.  
  3127.  
  3128.  ┌─────────────────────────────────────────────────────────────────────┐
  3129.  │ OnlyNewFiles                                                        │
  3130.  └─────────────────────────────────────────────────────────────────────┘
  3131.  Usage : This  option  works   something  different  than  the  NoMarked
  3132.          option.  When set,  MTA will look for  a file FILES.MTA in  the
  3133.          directory where  the source-archives  are.   MTA will  read the
  3134.          date/time of this file and  EVERY file with a date/time  HIGHER
  3135.          than the date/time of FILES.MTA will be converted.  At the  end
  3136.          of the conversion, MTA will  set the dat/time of the  FILES.MTA
  3137.          to the current date and time.
  3138.  
  3139.          If no   FILES.MTA is   present, MTA   will assume   0 for  both
  3140.          the date   and  time   (resulting  in   a  conversion   of  ALL
  3141.          selected files)  and will  create the  file when  conversion is
  3142.          done.
  3143.  
  3144.  Relate: None
  3145.  Dest. : All
  3146.  
  3147.  ┌─────────────────────────────────────────────────────────────────────┐
  3148.  │ DelOldFiles [mm-yyyy] {action}                                      │
  3149.  │ DelOldFiles [-days]   {action}                                      │
  3150.  └─────────────────────────────────────────────────────────────────────┘
  3151.  Usage : MTA   is able to   do some maintenance   for you also.    Users
  3152.          with big  libraries  of   archives  would  like  to  clean some
  3153.          of the older  ones, once in  a  while.  Also, BBS SysOp's  like
  3154.          to  remove  uploaded  files   when  they   are  too   old. Most
  3155.          protocol drivers (also FileDoor) have   such options but   most
  3156.          of them  only look at the file date (FileDoor looks inside  the
  3157.          archive). With  MTA you can  assign a  file date  that  depends
  3158.          on the files inside the  archives  (see  later).  If  you   did
  3159.          so, you can  use this option  to clean your  library from older
  3160.          files.
  3161.  
  3162.          [mm-yyyy]     Is the  month (2 bytes,  use leading zeros)   and
  3163.                        yyyy is the year of the oldest files you want  to
  3164.                        KEEP in your library.  If the file date  is lower
  3165.                        than [mm-yyyy], MTA  will do something  with that
  3166.                        file,  depending  on  the  presence of the second
  3167.                        parameter and the DelOldPath option;
  3168.  
  3169.          [-days]       You can also use this syntax as a replacement for
  3170.                        [mm-yyyy]. In this case, you supply the number of
  3171.                        days  that  must  be  subtracted from the current
  3172.                        date. This new date  will now be the marking-line
  3173.                        and  older  files  are  considered 'too old'. You
  3174.                        must  supply  the minus sign and a number of days
  3175.                        (up to 32767)  that  must  be subtracted from the
  3176.                        current date.
  3177.  
  3178.          {action}      {action} can have the following values:
  3179.  
  3180.                        NONE  : MTA  will sound  the bell  (if NoBeep  is
  3181.                                not set and WarningTime is not zero)  and
  3182.                                will   give   a   warning.   The   actual
  3183.                                manipulation of the file will follow;
  3184.  
  3185.                        NOMSG : MTA will  not sound  the bell,  nor  will
  3186.                                there be any message;
  3187.  
  3188.                        ASK   : MTA will  ask the user if this file  must
  3189.                                be manipulated  or not.  The file  IS too
  3190.                                old  (otherwise  no  questions  will   be
  3191.                                asked)  but  it  allows  you  to manually
  3192.                                exclude  some  of  the  files  from   the
  3193.                                manipulation  that  will  follow. You can
  3194.                                answer 'Y'  or 'N'.  This parameter  must
  3195.                                not  be  used  when  you  want to run MTA
  3196.                                unattended.
  3197.  
  3198.          If the DelOldPath option is NOT  set and the file IS marked  as
  3199.          too old (either direct or  after a positive reply when  you use
  3200.          the  ASK  parameter),  MTA  will   DELETE  the  file.  If   the
  3201.          DelOldPath option IS set and the file IS marked, MTA will  MOVE
  3202.          the file to the directory assigned in the DelOldPath option.
  3203.  
  3204.  Relate: DelOldPath
  3205.  Dest. : All
  3206.  
  3207.  
  3208.  ┌─────────────────────────────────────────────────────────────────────┐
  3209.  │ DelOldPath [dir]                                                    │
  3210.  └─────────────────────────────────────────────────────────────────────┘
  3211.  Usage : If DelOldFiles  is set  and a  file is  marked as too old,  MTA
  3212.          will delete the file, unless you supply the DelOldPath  option.
  3213.          If this  option is  supplied, MTA  will MOVE  (not delete)  the
  3214.          file to the assigned directory.
  3215.  
  3216.          [dir]         This value must point to a valid  drive/directory
  3217.                        where the files  are moved to  when they are  too
  3218.                        old.  If  no drive is  supplied, the default  one
  3219.                        is  used.   Relative  directories  (..\WRKDIR and
  3220.                        such) are not  advised but can  be used (the  are
  3221.                        counted from the CURRENT directory).
  3222.  
  3223.  Relate: DelOldFiles
  3224.  Dest. : All
  3225.  
  3226.  
  3227.  ┌─────────────────────────────────────────────────────────────────────┐
  3228.  │ SkipNewFiles [days]                                                 │
  3229.  └─────────────────────────────────────────────────────────────────────┘
  3230.  Usage : Where DelOldFiles will do something for files that are too old,
  3231.          this option can  be  used  to  skip  files  that are too new to
  3232.          convert.
  3233.  
  3234.          [days]        This value must be set to the number of days that
  3235.                        an archive can not be converted by MTA. Any value
  3236.                        between 1 and 65535 is valid.
  3237.  
  3238.          MTA will not  convert the files if the file-date/time is higher
  3239.          than [currentdate]-[days]. This  can  be useful  when you don't
  3240.          want to change archives for a certain number of days.
  3241.  
  3242.  Relate: None
  3243.  Dest. : All
  3244.  
  3245.  
  3246.  3.3.5 Statements that define the resulting files
  3247.  ───────────────────────────────────────────────────────────────────────
  3248.  MTA  includes  a  number  of  options  that  will  rule  the  resulting
  3249.  archives.   These include  optimizing the  files, the  comments to add,
  3250.  the files to add and remove from the archive and so on.
  3251.  
  3252.  ┌─────────────────────────────────────────────────────────────────────┐
  3253.  │ ExcludeFile [filemask]                                           (*)│
  3254.  │ ExcludeFile [filemask] {SUB}                                        │
  3255.  └─────────────────────────────────────────────────────────────────────┘
  3256.  Usage : Today there can be no archive that does not include some  files
  3257.          that have no relation with the actual archive but which  is/are
  3258.          added as some sort of advertisement. Every BBS adds, at  least,
  3259.          a comment in the  archive, so you can  read over and over  from
  3260.          which BBS the file came but there are also BBS Sysop's who  add
  3261.          files  to  the  archive  with  the same (or other) information.
  3262.          When I  had to  choose, I  would like  to see  NONE of the both
  3263.          ways (all the extra  bytes will cause longer  connections, thus
  3264.          costing money) but if  I had to choose  between one of them,  I
  3265.          would rather like to see included files than archive  comments.
  3266.          The included files are  compressed (thus costing less  transfer
  3267.          time)  but  the  comments  are  not  !  I wait for the day that
  3268.          SysOp's start to add  GIF's (640*480*256 or higher)  with their
  3269.          own  pictures.  In  that  case  we  all  can  have  fun when we
  3270.          download  an  archive  with  2   Kb  programs  and  300Kb   GIF
  3271.          advertisements !
  3272.  
  3273.          Normally, when you  obtain archives with  added advertisements,
  3274.          you would  like to  remove them  as soon  as possible. There is
  3275.          one thing positive about it, MOST SysOp's use the same name  of
  3276.          the  included  file(s)  over  and  over.  MTA  can remove these
  3277.          files, based  on their  name, AFTER  the decompression  AND the
  3278.          check for any virus. So  these files ARE included in  the check
  3279.          for a virus.
  3280.  
  3281.          [filemask]    The parameter must  contain a single   file-mask.
  3282.                        You  can  use  the  normal  DOS  wildcards (?,*).
  3283.                        Also  a  special  wildcard  (=)  can be used. '='
  3284.                        will test  for a  shifting match.  So '=WAR' will
  3285.                        match  tradeWAR.zip  and  also  WARning.ARC.  =FZ
  3286.                        will NOT  match with  nodedifF.Zip. In  this case
  3287.                        you  must  use  =F.Z.   You  must  only include a
  3288.                        file-mask and not a directory and/or drive;
  3289.  
  3290.          {SUB}         If you code  SUB  on  the ExcludeFile option, MTA
  3291.                        will also look  into all sub-directories that are
  3292.                        created by the  extraction. If  a  match is found
  3293.                        in a sub-directory, MTA  will also remove it from
  3294.                        the archive. If  the  parameter is NOT coded, MTA
  3295.                        will only  look  in the relative 'root' directory
  3296.                        of the archive.
  3297.  
  3298.          The  usage  of  the  '='  wildcard  can be handy when the SysOp
  3299.          alters the name of his/her  include file now and then.  In most
  3300.          cases you will see a range like this:
  3301.  
  3302.          JOHNDOE.ADD $JOHNDOE.ADD
  3303.          JOHNDOE$.ADD JOHNDOE.$$$
  3304.  
  3305.          It is a real  pain in the neck  and I can't see  the reason for
  3306.          doing so, but with =JOHNDOE for [filemask], you get rid of  all
  3307.          these files. Don't  use README or  READ.ME. If some  SysOp adds
  3308.          files like this as  an advertisement, they should  think twice.
  3309.          Most of the time, these files contain important info about  the
  3310.          package you have just obtained.
  3311.  
  3312.          You can use up to 255 (!) ExcludeFile statements in MTA.CTL.
  3313.  
  3314.  Relate: IncludeFile
  3315.  Dest. : All
  3316.  (*)   : Marked options are also in usage by: MTM
  3317.  
  3318. ExcludeFiles [mask] {SUB}
  3319.  
  3320. When the new SUB option is coded, MTA will also test if this mask will
  3321. match files in all SUB-directories that are extracted. If nothing is
  3322. supplied, only the root directory of the extracted files is tested;
  3323.  
  3324.  
  3325.  ┌─────────────────────────────────────────────────────────────────────┐
  3326.  │ IncludeFile [path] {newname} {CF$}                               (*)│
  3327.  └─────────────────────────────────────────────────────────────────────┘
  3328.  Usage : See  the  discussion   on  ExcludeFile. This option can do  the
  3329.          reversed. Where  ExcludeFile removes  any advertisement  files,
  3330.          IncludeFile can add your own advertisement !
  3331.  
  3332.          [path]        This value must point to a valid  drive/directory
  3333.                        and filename of the file to include. If no  drive
  3334.                        is supplied, the default  one is used.   Relative
  3335.                        directories (..\WRKDIR and such) are not  advised
  3336.                        but  can  be  used  (the  are  counted  from  the
  3337.                        CURRENT directory);
  3338.  
  3339.          {newname}     This optional  parameter can be  used to   change
  3340.                        the name of the  file assigned with [path]  as it
  3341.                        appears in  the archive.  For example,  if [path]
  3342.                        is   C:\COMMON\MYFILES.ASC   and   {newname}   is
  3343.                        JDOEBBS.ADD,  the  file  inside  the archive will
  3344.                        actually be called JDOEBBS.ADD. If you don't  use
  3345.                        the {newname} parameter, the file will be  called
  3346.                        MYFILES.ASC;
  3347.  
  3348.          {CF$}         This parameter is optional. When you use it,  the
  3349.                        {newname}  parameter  is  mandatory because {CF$}
  3350.                        MUST  be  the  third  parameter  !  When you code
  3351.                        CF$,  you  are  telling  MTA  that  the  file you
  3352.                        include is  in fact  an archive.   In this  case,
  3353.                        MTA will  convert the  included file  to the same
  3354.                        system as the target system for the archive.
  3355.  
  3356.          There can be up to 255 IncludeFile options in the MTA.CTL.  All
  3357.          files will be included  in EVERY converted extension.  When you
  3358.          leave  out  the  option,  nothing  is  included. I hope that no
  3359.          SysOp will use ALL 255 options for advertisement files.
  3360.  
  3361.  Relate: ExcludeFile
  3362.  Dest. : All
  3363.  (*)   : Marked options are also in usage by: MTM
  3364.  
  3365.  
  3366.  ┌─────────────────────────────────────────────────────────────────────┐
  3367.  │ TouchLow                                                            │
  3368.  └─────────────────────────────────────────────────────────────────────┘
  3369.  Usage : This parameter is optional and controls MTA's touching  system.
  3370.          When used, MTA touches (resets the compressed file's  time/date
  3371.          stamp) to  the lowest  date of  any file  inside the compressed
  3372.          file.  All  files  that  match  any supplied ExcludeFile option
  3373.          (see before)  are NOT  looked at.  As an  example, the  archive
  3374.          contains:
  3375.  
  3376.          A.A           12/31/91
  3377.          B.B           11/18/91
  3378.          C.C           01/01/92
  3379.          JOHNDOE.ADD   01/01/91
  3380.  
  3381.          JOHNDOE.ADD is not looked at  because it matches one (or  more)
  3382.          of  the  ExcludeFile  options.  With  TouchLow set, the archive
  3383.          will get the  date 11/18/91 (JOHNDOE.ADD  has a lower  date but
  3384.          is not looked at).
  3385.  
  3386.          When TouchLow is set, TouchCur and  TouchHig  can  not be used.
  3387.          When neither TouchLow  nor  TouchCur  nor TouchHig are set, MTA
  3388.          will retain the original file date/time;
  3389.  
  3390.  Relate: TouchCur, TouchHig, ChildTouch
  3391.  Dest. : All
  3392.  
  3393.  
  3394.  ┌─────────────────────────────────────────────────────────────────────┐
  3395.  │ TouchHig                                                            │
  3396.  └─────────────────────────────────────────────────────────────────────┘
  3397.  Usage : This parameter is optional and controls MTA's touching  system.
  3398.          When used, MTA touches (resets the compressed file's  time/date
  3399.          stamp) to the  highest date of  any file inside  the compressed
  3400.          file.  All  files  that  match  any supplied ExcludeFile option
  3401.          (see before)  are NOT  looked at.  As an  example, the  archive
  3402.          contains:
  3403.  
  3404.          A.A           12/31/91
  3405.          B.B           11/18/91
  3406.          C.C           01/01/92
  3407.          JOHNDOE.ADD   02/01/92
  3408.  
  3409.          JOHNDOE.ADD is not looked at  because it matches one (or  more)
  3410.          of  the  ExcludeFile  options.  With  TouchHig set, the archive
  3411.          will get the date 01/01/92  (JOHNDOE.ADD has a higher date  but
  3412.          is not looked at).
  3413.  
  3414.          When TouchHig is set, TouchCur and  TouchLow  can  not be used.
  3415.          When neither TouchLow  nor  TouchCur  nor TouchHig are set, MTA
  3416.          will retain the original file date/time;
  3417.  
  3418.  Relate: TouchCur, TouchLow, ChildTouch
  3419.  Dest. : All
  3420.  
  3421.  
  3422.  ┌─────────────────────────────────────────────────────────────────────┐
  3423.  │ TouchCur                                                            │
  3424.  │ TouchCur [+days]                                                    │
  3425.  └─────────────────────────────────────────────────────────────────────┘
  3426.  Usage : This parameter is optional and controls MTA's touching  system.
  3427.          When used, MTA touches (resets the compressed file's  time/date
  3428.          stamp) to the current date.
  3429.  
  3430.          When TouchCur is set, TouchHig and  TouchLow  can  not be used.
  3431.          When neither TouchLow  nor  TouchCur  nor TouchHig are set, MTA
  3432.          will retain the original file date/time.
  3433.  
  3434.          A special format  is the usage of [+days]. If this parameter is
  3435.          present, MTA will  add  the  number of days that is supplied in
  3436.          this parameter to the  current  date and will touch all archives
  3437.          with that new date (comes in  handy when using a BBS and giving
  3438.          the new uploads a new date in the future).
  3439.  
  3440.          [+days]       This  value  must  be  set to a plus sign and the
  3441.                        number of days (up to 365)  to add to the current
  3442.                        date;
  3443.  
  3444.  Relate: TouchLow, TouchHig, ChildTouch
  3445.  Dest. : All
  3446.  
  3447.  
  3448.  ┌─────────────────────────────────────────────────────────────────────┐
  3449.  │ ChildTouch [type]                                                   │
  3450.  └─────────────────────────────────────────────────────────────────────┘
  3451.  Usage : Normally, MTA will use  the same type of touching for  archives
  3452.          inside  archives  (nested  arc-in-arc  files)  as  for the main
  3453.          archive. When this is  not what you want,  you can make use  of
  3454.          this ChildTouch  option to  overrule the  touching with another
  3455.          method for nested archives.
  3456.  
  3457.          [type]        You must either  supply HIGH, LOW, CUR or   FILE.
  3458.                        When HIGH is used,  touching on the highest  date
  3459.                        will  occur  for  nexted  archives,  LOW  for the
  3460.                        lowest date,  CUR for  the current  date and FILE
  3461.                        will cause the original  date to be retained  for
  3462.                        these nested archives.
  3463.  
  3464.          As an example, you can  touch all archives on current  date (so
  3465.          they will show as  new files on a  BBS) but it is  logical that
  3466.          this is not desired for archives inside archives. These  nested
  3467.          archives can be touched in another way if you include this  op-
  3468.          tion;
  3469.  
  3470.  Relate: TouchLow, TouchHig, TouchCur
  3471.  
  3472.  
  3473.  ┌─────────────────────────────────────────────────────────────────────┐
  3474.  │ IgnoreTimeComponent                                              (*)│
  3475.  └─────────────────────────────────────────────────────────────────────┘
  3476.  Usage : This  option  belongs   to  the previous TouchHig and  TouchLow
  3477.          options. When  you use  this option  (you don't  have to),  the
  3478.          time-component  of  the  date/time  of  every  file  inside the
  3479.          archive is ignored. Sometimes you need such an option when  you
  3480.          use software that use the  spare bit of the time/date  field in
  3481.          the  DOS  directory  entry.  There  are  some  programs   (some
  3482.          commercial  backup  programs)  that  do  so. When the option is
  3483.          set, all archives will get the time 00:00:00 when the  TouchHig
  3484.          or TouchLow option is active.
  3485.  
  3486.  Relate: TouchLow, TouchHig
  3487.  Dest. : All
  3488.  (*)   : Marked options are also in usage by: MTM
  3489.  
  3490.  
  3491.  ┌─────────────────────────────────────────────────────────────────────┐
  3492.  │ AcceptHighDate                                                   (*)│
  3493.  └─────────────────────────────────────────────────────────────────────┘
  3494.  Usage : Also this option belongs to the TouchHig and TouchLow  options.
  3495.          Sometimes archives  contain files  with dates  higher than  the
  3496.          current date. MTA  will give a  warning for each  of such files
  3497.          inside any archive because it could be possible that your  PC's
  3498.          date is not correctly set. If this is normal, or if you  expect
  3499.          to receive files with higher (invalid) dates, you must use  the
  3500.          AcceptHighDate option.  The actual  archive will  also get  the
  3501.          high date when TouchLow or TouchHig are in use.
  3502.  
  3503.  Relate: TouchLow, TouchHig
  3504.  Dest. : All
  3505.  (*)   : Marked options are also in usage by: MTM
  3506.  
  3507.  
  3508.  ┌─────────────────────────────────────────────────────────────────────┐
  3509.  │ NoArcInArc                                                          │
  3510.  └─────────────────────────────────────────────────────────────────────┘
  3511.  Usage : MTA will convert  any archives inside archives (in  this manual
  3512.          we call them arc-in-arc files)  up to ANY level deep  (but with
  3513.          respect to the conventional memory available).
  3514.  
  3515.          When running DOS 5.0 on 286, 386 or 486 machines, it is  normal
  3516.          to have  around 600.000  (or more)  bytes of  memory free. With
  3517.          this number of bytes free (and when swapping is used), you  can
  3518.          go up to 80  levels deep (I have  never seen such a  file). You
  3519.          need around 200K to run MTA itself and every MTA child uses  4K
  3520.          extra overhead for swapping.
  3521.  
  3522.          Normally you should  let MTA convert  any archives inside.  But
  3523.          if  memory  is  low,  or  speed  is  slow  or  disk-space  (for
  3524.          swapping)  is  low,  you  CAN  select to leave arc-in-arc files
  3525.          alone. In this case a  TEST.ZIP, containing a TEST.ARJ and  the
  3526.          target is  LZH, will  result in  TEST.LZH containing  TEST.ARJ.
  3527.          When  the  option  is  NOT  set,  it  will  result in TEST.LZH,
  3528.          containing TEST.LZH !
  3529.  
  3530.          For each level of arc-in-arc files, MTA will call itself to  do
  3531.          the  job  on  the  nested  archives,  thus  giving all possible
  3532.          options (with a few restrictions).
  3533.  
  3534.  Relate: None
  3535.  Dest. : All
  3536.  
  3537.  
  3538.  ┌─────────────────────────────────────────────────────────────────────┐
  3539.  │ OptimizeOnSize                                                      │
  3540.  └─────────────────────────────────────────────────────────────────────┘
  3541.  Usage : MTA can also be used to make the smallest possible archive.  It
  3542.          needs a  selection of  different archive  programs to  complete
  3543.          this job  and it  will convert  any archive  to the system that
  3544.          will result in  the smallest archive  (this creating a  mixture
  3545.          of a number of different target systems).
  3546.  
  3547.          All archivers  that are  included in  the xxxPath  options (see
  3548.          3.3.1, the  first options)  and that  have a  'Y' as the second
  3549.          parameter, will be used for testing.
  3550.  
  3551.          YOU must select which archivers  to include in the test.  There
  3552.          are some combinations (that can change when newer versions  hit
  3553.          the street) that are useful.  ZIP, ARJ, LZH and ZOO  (2.1x) can
  3554.          give a good  result. Including MD  or ARJ in  this list has  NO
  3555.          meaning. They ALWAYS result in a bigger archive, but the  given
  3556.          combination works.
  3557.  
  3558.          For  each  archive,  MTA  will  call the selected archivers and
  3559.          will start to  convert the archive  to each of  them (one after
  3560.          another,  only  taking  disk-space  for  one of them). When the
  3561.          smallest is known, MTA will AGAIN start the conversion but  now
  3562.          with ALL possible options (IncludeFile and such) active.
  3563.  
  3564.          OptimizeOnSize  will  cause  MTA  to  run  [number of archivers
  3565.          selected]+1 times longer (average) than normal. Only when  your
  3566.          space is limited, this option should be used !
  3567.  
  3568.  Relate: None
  3569.  Dest. : All
  3570.  
  3571.  
  3572.  ┌─────────────────────────────────────────────────────────────────────┐
  3573.  │ OnlyUpgrade                                                         │
  3574.  └─────────────────────────────────────────────────────────────────────┘
  3575.  Usage : This option can be  useful when you want to convert  your files
  3576.          to  a  higher  technical  level.  In  general, OnlyUpgrade will
  3577.          cause the following files  (also based on the  file-mask(s)) to
  3578.          convert to the new target:
  3579.  
  3580.          - Files  that are  not in  the target  format (e.g.  ZIP is the
  3581.            destination, so all non-ZIP files will be converted);
  3582.  
  3583.          - Files that ARE in the target format (e.g. ZIP and the  target
  3584.            is also ZIP) but that  have a LOWER TECHNICAL level  than the
  3585.            current target;
  3586.  
  3587.          The latter looks  somewhat difficult to  understand, so I  will
  3588.          come to the  point. ZIP, PAK  and LZH have  different levels of
  3589.          archives. You have the older  LZH 1.13 format but the  new 2.xx
  3590.          format is  different, you  have the  older PAK  (crushed) files
  3591.          and today we  have also a  new PAK format  (distilled). For ZIP
  3592.          the same rules apply.
  3593.  
  3594.          In plain english for each archiver involved:
  3595.  
  3596.          - If  the source  and target  are LZH  and the  source contains
  3597.            1.13 formatted  files, conversion  will be  done to  the 2.xx
  3598.            format with LHA;
  3599.  
  3600.          - If  the source  and target  are PAK  and the  source contains
  3601.            crushed  files,  conversion  will  be  done  to the destilled
  3602.            format with PAK;
  3603.  
  3604.          - If  the source  and target  are ZIP  and the  source contains
  3605.            either reduced 1-4 files  or imploded files, conversion  will
  3606.            be  done  to  the  ZIP  2.xx  deflated  format  (the previous
  3607.            versions of  MTA up  to 14.57  only did  an upgrade  from 1-4
  3608.            reduced to imploding, 15.01 will convert to deflated);
  3609.  
  3610.          If the source archive already  contains one or more files  from
  3611.          the NEW systems (f.i.  3 x stored but  1 x deflated), MTA  will
  3612.          not convert it when ZIP is also the target.
  3613.  
  3614.  Relate: ZIP, PAK, LZH
  3615.  Dest. : ZIP, PAK, LZH
  3616.  
  3617.  
  3618.  ┌─────────────────────────────────────────────────────────────────────┐
  3619.  │ AllDisketteFiles                                                    │
  3620.  └─────────────────────────────────────────────────────────────────────┘
  3621.  Usage : When you  use the  /D command-line  parameter (start   diskette
  3622.          conversion), MTA will only  convert archives on the  diskettes.
  3623.          If you  want to  move the  files to  another diskette (with the
  3624.          MoveToDir option) or you want to format the diskette (with  one
  3625.          of the exits),  you must make  sure that ALL  files are reMOVED
  3626.          from  the  diskette.  These  files  will  not  be converted but
  3627.          (temporary) moved to the same directory as where the  converted
  3628.          files are stored (temporary). You can instruct MTA to move  ALL
  3629.          files from the diskette (and back!) by setting this option.
  3630.  
  3631.          Diskette  conversion  is  not  possible  when  the  OnlyUpgrade
  3632.          option is set !
  3633.  
  3634.  Relate: EXITBeforeFill, EXITAfterFill, MoveToDir
  3635.  Dest. : All
  3636.  
  3637.  
  3638.  ┌─────────────────────────────────────────────────────────────────────┐
  3639.  │ MakeArc [mask]                                                      │
  3640.  └─────────────────────────────────────────────────────────────────────┘
  3641.  Usage : MTA  is  able  to  convert  ANY NON-ARCHIVE file that is in the
  3642.          working  directory  when  it  has  started to convert archives.
  3643.          To  instruct  MTA  to  do such a thing, you must include one or
  3644.          more MakeArc (and optionally MakeArcExclude) option(s).
  3645.  
  3646.          [mask]        This must be a valid DOS (4DOS <tm> or DISP <tm>)
  3647.                        filemask (up to 12 characters, wildcards allowed)
  3648.                        of (a) non-archived file(s) that MTA must convert
  3649.                        along the way;
  3650.  
  3651.          MTA will convert all matching files to archives of the selected
  3652.          target-type on a one-to-one basis. An example:
  3653.  
  3654.          MakeArc *.*
  3655.  
  3656.          MTA detects the following files in the working directory:
  3657.  
  3658.          A.ZIP
  3659.          B.ARJ
  3660.          C.WAV
  3661.          D.DOC
  3662.          E.GIF
  3663.          Z.ZOO
  3664.  
  3665.          With a destination (target) of ZIP, the following will happen:
  3666.  
  3667.          A.ZIP will be converted to  A.ZIP
  3668.          B.ARJ  ,,  ,,    ,,     ,,  B.ZIP
  3669.          C.WAV  ,,  ,, archived into C.ZIP
  3670.          D.DOC  ,,  ,, archived into D.ZIP
  3671.          E.GIF  ,,  ,, archived into E.ZIP
  3672.          Z.ZOO  ,,  ,, converted to  Z.ZIP
  3673.  
  3674.          With  this example, MTA  will  archive every SINGLE file into a
  3675.          SINGLE archive. There can be up to 255 MakeArc options.
  3676.  
  3677.  Relate: MakeArcExclude
  3678.  Dest. : All
  3679.  
  3680.  
  3681.  ┌─────────────────────────────────────────────────────────────────────┐
  3682.  │ MakeArcExclude [mask]                                               │
  3683.  └─────────────────────────────────────────────────────────────────────┘
  3684.  Usage : This option  can be used in combination with the MakeArc option
  3685.          and can  be  used to narrow the selection of non-archived files
  3686.          that will be converted to an archive.
  3687.  
  3688.          [mask]        This must be a valid DOS (4DOS <tm> or DISP <tm>)
  3689.                        filemask (up to 12 characters, wildcards allowed)
  3690.                        of (a) non-archived file(s) that MTA must exclude
  3691.                        from the MakeArc process;
  3692.  
  3693.          MTA  will  exclude  all matching files from the archive process
  3694.          that is initialized by the MakeArc option(s). An example:
  3695.  
  3696.          MakeArc *.*
  3697.          MakeArcExclude *.GIF
  3698.          MakeArcExclude *.WAV
  3699.  
  3700.          MTA detects the following files in the working directory:
  3701.  
  3702.          A.ZIP
  3703.          B.ARJ
  3704.          C.WAV
  3705.          D.DOC
  3706.          E.GIF
  3707.          Z.ZOO
  3708.  
  3709.          With a destination (target) of ZIP, the following will happen:
  3710.  
  3711.          A.ZIP will be converted to  A.ZIP
  3712.          B.ARJ  ,,  ,,    ,,     ,,  B.ZIP
  3713.          C.WAV  ,,  ,, archived into C.WAP
  3714.          D.DOC  ,,  ,, archived into D.ZIP
  3715.          E.GIF  ,,  ,, left alone as E.GIF  <------------
  3716.          Z.ZOO  ,,  ,, converted to  Z.ZIP
  3717.  
  3718.          With this  example, MTA  will  archive every SINGLE file into a
  3719.          SINGLE archive except GIF files !
  3720.  
  3721.  Relate: MakeArc
  3722.  Dest. : All
  3723.  
  3724.  
  3725.  ┌─────────────────────────────────────────────────────────────────────┐
  3726.  │ KeepAbnormalExtensions                                              │
  3727.  └─────────────────────────────────────────────────────────────────────┘
  3728.  Usage : Some of  the archives contain a  special extension that is  not
  3729.          common with the archive system. You can receive files with  the
  3730.          extension  .A25,  .SDN  and  so  on.  Normally MTA will convert
  3731.          these archives (unless excluded  by DoNot or the  file-mask) to
  3732.          a  new  archive  with  a  NORMAL  extension  (e.g. ZIP when you
  3733.          convert to ZIP). If you include this option, MTA will keep  the
  3734.          abnormal extension even after the conversion. So A.SDN (in  ZIP
  3735.          format), converted to ARJ, will still be called A.SDN.
  3736.  
  3737.          Only one archive system can not work with abnormal  extensions.
  3738.          DWC can only  work with archives  that end with  .DWC. When you
  3739.          convert A.SDN (in ZIP format) to DWC, the result will be  named
  3740.          A.DWC !
  3741.  
  3742.  Relate: None
  3743.  Dest. : All
  3744.  
  3745.  
  3746.  ┌─────────────────────────────────────────────────────────────────────┐
  3747.  │ WeekExtension [ext] [letter]                                        │
  3748.  └─────────────────────────────────────────────────────────────────────┘
  3749.  Usage : There are archives with a very special extension. These are the
  3750.          archives that (f.i.) contain the BBS-nodelist and BBS-nodediff
  3751.          files. These extensions are made up by a letter (normally a A)
  3752.          and two digits that are the last two digits of a day-number.
  3753.          In this manner, files with names like NODEDIFF.A21 can be found
  3754.          on various BBS's.
  3755.  
  3756.          There have been some proposals and standards as how to use these
  3757.          extensions for BBS-nodelist/nodediff files. As fas as I know,
  3758.          there is only one valid standard and that is the usage of ARC
  3759.          (SEA ARC, crunched) files with extension Axx (xx are the last
  3760.          two digits of the day-number). Some nets use other archivers
  3761.          for these files (like ZIP, ARJ and LZH). To keep a difference
  3762.          between these SEA ARC (Axx) files and those converted to any of
  3763.          the other systems, nets use different letters. As such the
  3764.          following list looks more or less standard (but is not covered
  3765.          by a formal fidonet-standard):
  3766.  
  3767.          SEA ARC         xxxxxxxx.Ann
  3768.          ZIP             xxxxxxxx.Znn
  3769.          ARJ             xxxxxxxx.Jnn
  3770.          LZH/LZS         xxxxxxxx.Lxx
  3771.  
  3772.          MTA can be used to maintain such a  system. Normally,  you  can
  3773.          supply   the  KeepAbnormalExtensions  option  to  maintain  the
  3774.          original extension of a file, but this would cause NODEDIFF.A10
  3775.          to keep  its original  extension  (A10)  even when  the file is
  3776.          actually converted to ZIP (Z10 would be better).
  3777.  
  3778.          You can  use  the  WeekExtension option(s) (up to 20) to inform
  3779.          MTA how  files  with the an extension made up by one letter and
  3780.          two  digits  (A01,  Z11, J18 and so on) should be (re)named. If
  3781.          you do not supply this option, MTA will either convert the name
  3782.          to a  normal  archive-extension or to the original extension if
  3783.          the  KeepAbnormalExtensions option is active. The WeekExtension
  3784.          option is set for the target-file !
  3785.  
  3786.          [ext]         This parameter must  be set to the NORMAL archive
  3787.                        extension  that  the  target-file would have been
  3788.                        given (like ZIP, ARJ, ARC and so on);
  3789.  
  3790.          [letter]      This  parameter  must be set to the letter of the
  3791.                        new  extension  that belongs to [ext] (like Z for
  3792.                        ZIP, L of LZH/LZS or J for ARJ).
  3793.  
  3794.          When  MTA  starts  converting an archive with an extension that
  3795.          is made  up  by  a letter and two numbers AND the new extension
  3796.          that the  archive  should  get under normal conditions (LZH for
  3797.          LHarc, ZIP  for  ZIP,  ARJ  for  ARJ and so on) is defined by a
  3798.          WeekExtension  option,  MTA  will  use  the supplied letter and
  3799.          will create  a  new extension with this letter and the original
  3800.          two digits. For example:
  3801.  
  3802.          WeekExtension ARC A
  3803.          WeekExtension ZIP Z
  3804.          WeekExtension LZH L
  3805.          WeekExtension LZS L
  3806.          WeekExtension ARJ J
  3807.  
  3808.          Source-archive  is  called  NODEDIFF.A12 and conversion is done
  3809.          to ZIP.  ZIP  is inside the array and 'owns' letter 'Z', so the
  3810.          new archive  will  be called NODEDIFF.Z12. Source is RA.H11 and
  3811.          conversion is  done  to ARJ. ARJ is in the array and 'owns' the
  3812.          letter 'J' so  the new archive is called RA.J11. Source archive
  3813.          is  called  DISP.J01  and conversion is done to HYPER. HYP (the
  3814.          extension  for  a normal HYPER archive) is NOT in the array so,
  3815.          unless  KeepAbnormalExtensions  is set, the new archive will be
  3816.          called DISP.HYP !
  3817.  
  3818.          Because  of the lack of rules for the conversion of extensions,
  3819.          MTA uses a 'dynamic' system.
  3820.  
  3821.  Relate: KeepAbnormalExtensions
  3822.  Dest. : All
  3823.  
  3824.  
  3825.  ┌─────────────────────────────────────────────────────────────────────┐
  3826.  │ FixedConversion [mask] [target]                                     │
  3827.  └─────────────────────────────────────────────────────────────────────┘
  3828.  Usage : There can  be  up  to 255 of these options in MTA.CTL. For each
  3829.          file  that  is  selected  for  processing, MTA  will look if it
  3830.          matches  any [mask] in  the FIXEDCONVERSION option. If the name
  3831.          matches  [mask] (the first  match will count), MTA will convert
  3832.          the file  to  the [target] format EVEN if the default format is
  3833.          something else.
  3834.  
  3835.          [mask]        This must be a valid DOS (4DOS <tm> or DISP <tm>)
  3836.                        filemask (up to 12 characters, wildcards allowed)
  3837.                        that will have a fixed conversion;
  3838.  
  3839.          [target]      This must be a valid name of the  target archiver
  3840.                        (or convertor  in case  of  GIF-alike files). The
  3841.                        valid names  are  the same as you supply with the
  3842.                        COMPRESSIONTYPE  option (ZIP,  ARJ, ARC, ZOO, GIF
  3843.                        and so on);
  3844.  
  3845.          For example:
  3846.  
  3847.          FixedConversion NODELIST.A?? ARC
  3848.          FixedConversion NODEDIFF.A?? ARC
  3849.  
  3850.          Will force  MTA to  convert  any selected file with one of that
  3851.          names, to the  ARC  format, even  if the selected target-format
  3852.          is ZIP.
  3853.  
  3854.          This option comes in handy when certain files always have to be
  3855.          converted to a fixed system.
  3856.  
  3857.          All other options like WEEKEXTENSION and KEEPABNORMALEXTENSION
  3858.          will still word.
  3859.  
  3860.  Relate: None
  3861.  Dest. : All
  3862.  
  3863.  
  3864.  ┌─────────────────────────────────────────────────────────────────────┐
  3865.  │ ReportSpecialAttributes                                             │
  3866.  │ ReportSpecialAttributes SKIP                                        │
  3867.  └─────────────────────────────────────────────────────────────────────┘
  3868.  Usage : Some archives  can contain files with  abnormal file-attributes
  3869.          like  HIDDEN,  READONLY  and/or  SYSTEM.  If  the decompression
  3870.          program is  able to  decompress these  files in  this way,  you
  3871.          could be in for trouble (though MTA will remove any left  files
  3872.          after the conversion). If you like to, MTA can report  archives
  3873.          that contain such files when you set this option. Also, when
  3874.          this option is set, MTA will reset all attributes that are not
  3875.          'normal' (READONLY, HIDDEN and SYSTEM) before the new archive
  3876.          is created.
  3877.  
  3878.          When SKIP is supplied, MTA will not convert the attributes and
  3879.          will not even convert the archive. The archive is moved to the
  3880.          error-directory and conversion must be done by hand.
  3881.  
  3882.  
  3883.  Relate: None
  3884.  Dest. : All
  3885.  
  3886.  
  3887.  ┌─────────────────────────────────────────────────────────────────────┐
  3888.  │ ReportInvalidFiles                                                  │
  3889.  └─────────────────────────────────────────────────────────────────────┘
  3890.  Usage : It is  invalid  (and dangerous) when an archive contains one of
  3891.          more  files  with  a name equal to a device-name in your PC. To
  3892.          overcome any  problems  with  these archives, you should remove
  3893.          them !
  3894.  
  3895.          MTA is  (optionally)  able  to  test  EVERY filename inside the
  3896.          archive  against  ALL  CURRENT  device-driver  names  you  have
  3897.          active  in your  PC. If  you  set  this  option  (it  is highly
  3898.          recommened  that  you  do  so),  MTA  will perform these checks,
  3899.          otherwise  (no option)  it  won't.  Testing  of  all files will
  3900.          only take a few moments extra !
  3901.  
  3902.          In  general, only  when  this  option  will  cause  problems in
  3903.          your PC,  you  should  not  include  it, otherwise  include the
  3904.          option !
  3905.  
  3906.  Relate: None
  3907.  Dest. : All
  3908.  
  3909.  
  3910.  ┌─────────────────────────────────────────────────────────────────────┐
  3911.  │ KeepAV                                                              │
  3912.  └─────────────────────────────────────────────────────────────────────┘
  3913.  Usage : Both ARJ and ZIP can create archives with a special  attribute,
  3914.          called  the  security  envelope/Authentification  Verification.
  3915.          Normally these files are created by the original author of  the
  3916.          program(s) that are included and  the code functions as a  kind
  3917.          of proof that the file  is untouched by others (virus,  patches
  3918.          and so on). One piece of  bad luck is that some BBS's  also use
  3919.          the  AV/Security  Envelope  to  mark  these  files as 'theirs',
  3920.          destroying the original idea behind the AV/SE code.
  3921.  
  3922.          When you  want to  keep files  with a  valid AV/SE  as they are
  3923.          (and you should  do so, certainly  on a BBS),  you must include
  3924.          this option.  If MTA  detects such  an archive  it will  do the
  3925.          following:
  3926.  
  3927.          - Decompress the file
  3928.  
  3929.          - Test for any virus (still)
  3930.  
  3931.          - Perform the exists involved;
  3932.  
  3933.          - Remove all decompressed files;
  3934.  
  3935.          - Include any new files to the original file (only ZIP);
  3936.  
  3937.          - Add comments to the original file (only ZIP);
  3938.  
  3939.          - If the  source is an  SFX, it CAN  be converted to  a non-SFX
  3940.            file of the same system (when you set the SFXFiles option);
  3941.  
  3942.          The  original  archive  is  kept  as  it was. Only some special
  3943.          files could be added and, optionally a comment header (ZIP).
  3944.  
  3945.  Relate: IncludeAVFile
  3946.  Dest. : All
  3947.  
  3948.  
  3949.  ┌─────────────────────────────────────────────────────────────────────┐
  3950.  │ IncludeAVFile [filemask] {AVCode}                                   │
  3951.  └─────────────────────────────────────────────────────────────────────┘
  3952.  Usage : As you have read  in the previous option, there are  situations
  3953.          where the  AV/SE code  has NO  meaning whatsoever.  You can use
  3954.          this option to instruct MTA  WHICH AV/SE files must keep  their
  3955.          code. All  others will  be stripped  EVEN if  the KeepAV option
  3956.          forces MTA not to do so.
  3957.  
  3958.          [filemask]    The parameter must  contain a single   file-mask.
  3959.                        You  can  use  the  normal  DOS  wildcards (?,*).
  3960.                        Also  a  special  wildcard  (=)  can be used. '='
  3961.                        will test  for a  shifting match.  So '=WAR' will
  3962.                        match  tradeWAR.zip  and  also  WARning.ARC.  =FZ
  3963.                        will NOT  match with  nodedifF.Zip. In  this case
  3964.                        you  must  use  =F.Z.   You  must  only include a
  3965.                        file-mask and not a directory and/or drive;
  3966.  
  3967.          {AVCode}      When this  parameter  is  NOT  present, all files
  3968.                        that  match  [filemask]  will  keep their AV-code
  3969.                        (e.g.  they  will  not be converted) if KeepAV is
  3970.                        set. You  can  also  supply  a  valid  AV-code or
  3971.                        AV-code-mask  overhere. In  this  case, all files
  3972.                        that  match  [filemask] AND  that  match {AVCode}
  3973.                        will  keep  their  AV-code (e.g. they will not be
  3974.                        converted)  when  KeepAV  is  set. You can either
  3975.                        supply  a  full  AV-code  overhere (like 0000 for
  3976.                        the  AV-code  that comes with original ARJxxx.EXE
  3977.                        distribution  file  or PKW655 that comes with the
  3978.                        original  PKLTExxx.EXE file)  or a mask. The mask
  3979.                        can  include  2  types of characters.  Either a #
  3980.                        (for numeric  digit)  or @ (for alphabetic digit)
  3981.                        can be  used in combination with real digits. For
  3982.                        example,  P@W###  will  cause  a match for PKW655
  3983.                        but NOT for P1WA11;
  3984.  
  3985.          Most obvious  you would  like to  keep the  AV/E codes for some
  3986.          general  files  like SCAN*.*, CLEAN*.*, 4DOS*.* and so on. Some
  3987.          examples are included in the archive. Some general hits:
  3988.  
  3989.          - When you want to keep all ZIP AV-codes, you can supply
  3990.            IncludeAVFile *.* @@@###
  3991.          - When you want to keep all ARJ AV-codes, you can supply
  3992.            IncludeAVFile *.* ####
  3993.          - Independent of the IncludeAVFile options you MUST set the
  3994.            KeepAV option to actually KEEP the AV-codes (e.g. no con-
  3995.            version of the archive). If there is a matching IncludeAVFile
  3996.            but NO KeepAV option, the archive will still be converted;
  3997.  
  3998.          There can be up to 512 IncludeAVFile options in MTA.CTL !
  3999.  
  4000.  Relate: KeepAV, ExcludeAVFile
  4001.  Dest. : All
  4002.  
  4003.  
  4004.  ┌─────────────────────────────────────────────────────────────────────┐
  4005.  │ ExcludeAVFile [filemask] [AVCode] {KEEP│DELETE│MOVE}                │
  4006.  └─────────────────────────────────────────────────────────────────────┘
  4007.  Usage : This option works is  the reversed of the IncludeAVFiles option
  4008.          described above. The  combination of In- and ExcludeAVFiles can
  4009.          result in  a  very nifty  management of archives with AV-codes.
  4010.          The number of ExcludeAVFile options that can be used is 512.
  4011.  
  4012.          The  ExcludeAVFile  option  is  tested  AFTER  A MATCH from the
  4013.          IncludeAVFile  is  found. If  it then matches the ExcludeAVFile
  4014.          option, it  is  again  excluded  AV  operation an the AV is not
  4015.          kept. If  you  did not use any IncludeAVFile (but KeepAV is set)
  4016.          you can  still use this option. In this case ALL AV'ed archives
  4017.          match (e.g. there  is  no  specific  IncludeAVFile) and you can
  4018.          exclude them again with this option.
  4019.  
  4020.          The  first  two  parameters for the ExcludeAVFile opion are the
  4021.          same as those on the IncludeAVFile option.
  4022.  
  4023.          The ExcludeAVFile  option  can use an extra parameter (when you
  4024.          compare it  with  the IncludeAVFile option). This parameter can
  4025.          have the following value:
  4026.  
  4027.          KEEP   : KEEP is the  default  so it can be left out. When KEEP
  4028.                   mode is  selected, MTA  will  leave  the AV'ed archive
  4029.                   when it matches the ExcludeAVFile option in question;
  4030.  
  4031.          MOVE   : When MOVE is used and the AV'ed archive will match the
  4032.                   given  ExcludeAVFile  option, the file is MOVED to the
  4033.                   error directory;
  4034.  
  4035.          DELETE : When DELETE  is  used and the AV'ed archive will match
  4036.                   the given  ExcludeAVFile  option,  the file is deleted
  4037.                   from  the  disk. This  comes in handy when you want to
  4038.                   remove  all  bogus-files  with a bogus-AVcode. Because
  4039.                   both the  ARJ  and ZIP AV-codes are cracked, there are
  4040.                   some  bogus  codes  in  the  circuit. If you know one,
  4041.                   you  can  include  the  ExcludeAVFile  option for this
  4042.                   AV-code, along with the DELETE option;
  4043.  
  4044.          Example 1:
  4045.  
  4046.          IncludeAVFile *.* ####            (include all ARJ's)
  4047.          IncludeAVFile *.* @@@###          (include all ZIP's)
  4048.          ExcludeAVFile *.* 0123    KEEP    (EXclude ARJ AV 123)
  4049.  
  4050.          A file A.ZIP enters  with AV-code PKQ001. It matches the second
  4051.          IncludeAVFile option  and does not match the ExcludeAVFile. Now
  4052.          a B.ARJ with code  123 enters. This  file  matches the first of
  4053.          the IncludeAVFile  options  but  also matches the ExcludeAVFile
  4054.          option. It is kept as it was and no conversion will take place.
  4055.  
  4056.          Example 2:
  4057.  
  4058.          IncludeAVFile MT*.* RVH001
  4059.          ExcludeAVFile M*.*  RVH001 DELETE
  4060.  
  4061.          MTA_VXXX.ZIP  with AV-code  RVH001 enters. It matches MT*.* but
  4062.          also M*.* and  is  deleted. Both  Include and exclude match but
  4063.          the exclude is tested last and has a higher priority !
  4064.  
  4065.  Relate: KeepAV, IncludeAVFile
  4066.  Dest. : All
  4067.  
  4068.  
  4069.  ┌─────────────────────────────────────────────────────────────────────┐
  4070.  │ KeepAVNoCode                                                        │
  4071.  └─────────────────────────────────────────────────────────────────────┘
  4072.  Usage : If MTA is  unable  to  extract  the AV-code or AV-user from the
  4073.          archive  (see AVCODES.TEC file) where the original file 'looks'
  4074.          like a file  that  has an AV-code, MTA will mark those files as
  4075.          NOT having  the AV-code  and they are converted. If you include
  4076.          this option, MTA  will  always  KEEP the file in original state
  4077.          (when  KEEPAV  is  also  included), though  there  is  no check
  4078.          against the  IncludeAVFile  and  ExcludeAVFile options possible
  4079.          (there is no AV-code/AV-user obtained from the archive);
  4080.  
  4081.  Relate: KeepAV, IncludeAVFile, ExcludeAVFile
  4082.  Dest. : All
  4083.  
  4084.  
  4085.  ┌─────────────────────────────────────────────────────────────────────┐
  4086.  │ KeepVolLabel                                                        │
  4087.  └─────────────────────────────────────────────────────────────────────┘
  4088.  Usage : Both ARJ and ZIP can contain (optionally) a volume label.  This
  4089.          is  sometimes  used  for  ARJ/ZIP  files  that are a compressed
  4090.          image of a diskette.
  4091.  
  4092.          MTA uses some  special techniques to  enforce the volume  label
  4093.          inside a  ZIP or  ARJ (if  any). The  technique only works when
  4094.          you have the SubstDrive option set and is as follows:
  4095.  
  4096.          - The current  volume-label of the  substituted drive is  read.
  4097.            This is the same label  as the drive containing the  ORIGINAL
  4098.            directory that is now used  for the substitution (in fact  it
  4099.            IS the volume label of that drive);
  4100.  
  4101.          - The ARJ or  ZIP is read. If  it contains no volume-label,  it
  4102.            will be converted as normal;
  4103.  
  4104.          - If it  contains a volume-label,  MTA will decompress  it with
  4105.            the option to decompress the volume-label as well;
  4106.  
  4107.          - The target system will  be called to compress the  file again
  4108.            (if it supports volume-labels,  those options are also  added
  4109.            by MTA);
  4110.  
  4111.          - MTA will reset  the volume-label to the original value unless
  4112.            there was no previous value, in which case MTA will set the
  4113.            label to MTA TMP LBL;
  4114.  
  4115.  Relate: None
  4116.  Dest. : ZIP, ARJ
  4117.  
  4118.  
  4119.  ┌─────────────────────────────────────────────────────────────────────┐
  4120.  │ NoCloakedArchives {ALL}                                             │
  4121.  └─────────────────────────────────────────────────────────────────────┘
  4122.  Usage : Some achives are repacked recursively. For example, someone has
  4123.          created MYFILES.ZIP (with 15 files inside). Now  this  file  is
  4124.          for some  reason  packed  again  to MYFILES.ZIP. You now have a
  4125.          file  MYFILES.ZIP  with  ONE  file  inside  (MYFILES.ZIP). This
  4126.          included  file  contains  the real files. This type of files is
  4127.          very dangerous  to process from the command-line. If you should
  4128.          unpack  MYFILES.ZIP  with 'PKUNZIP MYFILES.ZIP', PKUNZIP  would
  4129.          report a message, asking to overwrite the existing file. If you
  4130.          answer 'Y'es, PKUNZIP will start doing so and while the work is
  4131.          in  progress,  PKUNZIP  could  overwrite  parts of the original
  4132.          archive  MYFILES.ZIP  with  new  data  from  the extracted file
  4133.          MYFILES.ZIP. This will cause  a damaged source AND target file.
  4134.  
  4135.          On BBS's  this  type of archives is sometimes created to show a
  4136.          newer  file-date  than  the  actual  files  inside  are (a  bad
  4137.          behaviour) or  it  can  happen as a result of a conversion of a
  4138.          complete  package  (originally  containing INSTALL.ARC which is
  4139.          now converted to, lets say, INSTALL.ZIP).
  4140.  
  4141.          If you include  the  NoCloakedArchives option, MTA will test if
  4142.          the  archive  will  ontain  ONE file AND that file has the same
  4143.          name  as  the  original archive. You can also add the parameter
  4144.          ALL in  which case MTA will test of ANY file inside the archive
  4145.          has the  same name as the archive itself. When the test matches,
  4146.          MTA will move the archive to the error-directory.
  4147.  
  4148.  Relate: None
  4149.  Dest. : All
  4150.  
  4151.  
  4152.  ┌─────────────────────────────────────────────────────────────────────┐
  4153.  │ SkipBackups                                                         │
  4154.  └─────────────────────────────────────────────────────────────────────┘
  4155.  Usage : Both ARJ and ZOO can contain (optionally) backups. These  files
  4156.          are normally not  decompressed by MTA  and will be  lost unless
  4157.          you have set special options for both ARJ and ZOO.
  4158.  
  4159.          If you want  to keep the  backups, you can  force MTA to  leave
  4160.          this archives as they were. In fact, they are skipped when  you
  4161.          supply this option  ! Normal ARJ/ZOO  files that DON'T  contain
  4162.          backup versions are processed as before.
  4163.  
  4164.  Relate: None
  4165.  Dest. : ZOO, ARJ
  4166.  
  4167.  
  4168.  ┌─────────────────────────────────────────────────────────────────────┐
  4169.  │ OverwriteDuplicates                                                 │
  4170.  └─────────────────────────────────────────────────────────────────────┘
  4171.  Usage : Normally  MTA will never  overwrite any duplicate  file. If you
  4172.          convert A.ZIP  and A.ARJ  to ZOO,  it will  result in A.ZOO and
  4173.          A.ZO1 (the second  archive will be  renamed but will  NOT erase
  4174.          the other). If you  supply the OverwriteDuplicates option,  MTA
  4175.          WILL overwrite any file with the same name. This also goes for
  4176.          files that are moved to the error-directory and/or the trashcan
  4177.          directory !
  4178.  
  4179.  Relate: None
  4180.  Dest. : All
  4181.  
  4182.  
  4183.  ┌─────────────────────────────────────────────────────────────────────┐
  4184.  │ Description                                                         │
  4185.  └─────────────────────────────────────────────────────────────────────┘
  4186.  Usage : Most archivers have the  option to add a description to  one or
  4187.          more (or all)  components inside the  archive. If you  set this
  4188.          option, MTA  will add  options for  the target  to ask for such
  4189.          comments. THIS IS MANUAL WORK,  DON'T USE THIS OPTION WHEN  MTA
  4190.          MUST RUN UNATTENDED !!
  4191.  
  4192.  Relate: Autodescription
  4193.  Dest. : All
  4194.  
  4195.  
  4196.  ┌─────────────────────────────────────────────────────────────────────┐
  4197.  │ Autodescription [path]                                           (*)│
  4198.  └─────────────────────────────────────────────────────────────────────┘
  4199.  Usage : When you want to include a comment header in your target  file,
  4200.          you can use this option to do so (automatically). Those  target
  4201.          systems that  support it,  will be  instructed to  add a common
  4202.          header  to  each  and  every  converted  archive. Currently the
  4203.          comment can be added to ZIP, ZOO, ARJ and PAK files.
  4204.  
  4205.          [path]        This value must point to a valid  drive/directory
  4206.                        and  filename  of  the  file  which  include  the
  4207.                        actual comment.   If no  drive is  supplied,  the
  4208.                        default  one  is   used.   Relative   directories
  4209.                        (..\WRKDIR and such) are  not advised but can  be
  4210.                        used   (the   are   counted   from   the  CURRENT
  4211.                        directory).    The   file   must   be   a  normal
  4212.                        text-file. It can be a ANSI file (not  preferred,
  4213.                        most  archivers   won't  display   ANSI-sequences
  4214.                        unless specifically told, because ANSI  sequences
  4215.                        can  reconfigure  the  key-  board.  You would be
  4216.                        surprises and angry to  see that F3 now  starts a
  4217.                        FORMAT  of  your  hard-disk),  but  a normal pain
  4218.                        ASCII file  is best.  The total  size can  not be
  4219.                        greater than 64000 bytes.
  4220.  
  4221.          The AutoDescription can also be combined with the  CarryComment
  4222.          option (see BBS options) to gain maximum result !
  4223.  
  4224.          MTA uses the quickest  but safest way to  add the comment to  a
  4225.          file. In most cases piping  will be used (PKZIP -z  A <comment)
  4226.          but sometimes special options.
  4227.  
  4228.  Relate: Description
  4229.  Dest. : ARJ, ZIP, ZOO, PAK
  4230.  (*)   : Marked options are also in usage by: MTM
  4231.  
  4232.  
  4233.  3.3.6 Your own (new) compressor
  4234.  ───────────────────────────────────────────────────────────────────────
  4235.  The following  statements can  be used  to define  a compressor that is
  4236.  not (yet)  included in  MTA. If  you find  a compressor  that meets the
  4237.  standard to be included into MTA then please contact the author.
  4238.  
  4239.  Your OWN compression and decompression programs must follow some  basic
  4240.  rules and it is only needed to  include them if they are not yet  added
  4241.  to the STANDARD MTA support. The following rules apply:
  4242.  
  4243.  - They must report an errorlevel higher than 0 if errors occur;
  4244.  
  4245.  - The first errorlevel that reports  an error can not be followed  by a
  4246.    higher errorlevel that does NOT report an error;
  4247.  
  4248.  - The compressor MUST have an  option to delete the files it  has added
  4249.    to the archive;
  4250.  
  4251.  - The decompressor CAN have  recursive support. This also goes  for the
  4252.    compressor. It is not mandatory;
  4253.  
  4254.  - You can NOT use a batch-file to call the compressor/decompressor;
  4255.  
  4256.  - The  compression  system  must  use  its  own  extension (CRA in  the
  4257.    following examples);
  4258.  
  4259.  - Sometimes  you can  use the  support for  OWN compressors to overrule
  4260.    the  normal  compression/decompression  programs  that  MTA  supports
  4261.    internally, but you are on your own;
  4262.  
  4263.  
  4264.  ┌─────────────────────────────────────────────────────────────────────┐
  4265.  │ OwnCompressPath   [path] {opt} {DynSwapSiz} {second path}           │
  4266.  │ OwnDeCompressPath [path] {opt} {DynSwapSiz} {second path}           │
  4267.  └─────────────────────────────────────────────────────────────────────┘
  4268.  Usage : For your own  compression and decompression program, these  two
  4269.          statements must  be included.  The syntax  is the  same as  all
  4270.          other  xxxPath  options.  OwnCompressPath and OwnDecompressPath
  4271.          must point  to the  same file  if compression/decompression  is
  4272.          combined in one program.
  4273.  
  4274.  Relate: All Own-options
  4275.  Dest. : OWN
  4276.  
  4277.  
  4278.  ┌─────────────────────────────────────────────────────────────────────┐
  4279.  │ OwnCompressCall   [parms2use]                                       │
  4280.  │ OwnDeCompressCall [param2use]                                       │
  4281.  └─────────────────────────────────────────────────────────────────────┘
  4282.  Usage : When  using a customized  compression program, you  must supply
  4283.          the  parameters  to  be  passed  to  this program in the option
  4284.          OwnCompressCall.  For  any  decompression,  you must supply the
  4285.          parameters in the OwnDecompressCall option.
  4286.  
  4287.          [parms2use]   This parameter  must be  set in  a way  that  the
  4288.                        following sequence is started for compression:
  4289.  
  4290.                        - Compress all files in the current directory  in
  4291.                          the new archive;
  4292.  
  4293.                        - Delete all files from the current directory  or
  4294.                          compress with a move option (implicit delete);
  4295.  
  4296.                        This  parameter  must  be  set  in a way that the
  4297.                        following sequence is started for decompression:
  4298.  
  4299.                        - DeCompress all  files in the  current directory
  4300.                          from  the  new  archive;  The  name  of the new
  4301.                          archive is included  at the location  where you
  4302.                          add %1 in this parameter.
  4303.  
  4304.  Relate: All Own-options
  4305.  Dest. : OWN
  4306.  
  4307.  
  4308.  ┌─────────────────────────────────────────────────────────────────────┐
  4309.  │ OwnCompressLowErrorRC   [errornumber]                               │
  4310.  │ OwnDecompressLowErrorRC [errornumber]                               │
  4311.  └─────────────────────────────────────────────────────────────────────┘
  4312.  Usage : When  you  include   a  customized (de)compressor, you have  to
  4313.          supply the  LOWEST DOS  errorlevel given  by the (de)compressor
  4314.          when something is WRONG.
  4315.  
  4316.          [errornumber] This  parameter  must  be  the lowest  errorlevel
  4317.                        returned  by  the  (de)compression  program  when
  4318.                        something is wrong. Values must be between 1  and
  4319.                        255;
  4320.  
  4321.  Relate: All Own-options
  4322.  Dest. : OWN
  4323.  
  4324.  
  4325.  ┌─────────────────────────────────────────────────────────────────────┐
  4326.  │ OwnExtension [extension]                                            │
  4327.  └─────────────────────────────────────────────────────────────────────┘
  4328.  Usage : When  you want MTA  to 'see' your  customized compressed files,
  4329.          you have to supply  the name of the  extension MTA has to  look
  4330.          for. This can only be 1 extension (e.g. OWN).
  4331.  
  4332.          [extension]   This parameter must  be the (up to 3 bytes  long)
  4333.                        extension of the compressed files that are  ruled
  4334.                        under the OWN options.
  4335.  
  4336.          For every file that confirms to the supplied file-mask(s),  MTA
  4337.          will FIRST look if it  has an 'OwnExtension'. In that  case MTA
  4338.          will decompress  the file  with the  supplied decompressor.  If
  4339.          the destination is OWN, MTA instruct the customized  compressor
  4340.          to create files with extension 'OwnExtension'.
  4341.  
  4342.  Relate: All Own-options
  4343.  Dest. : All, including source OWN
  4344.  
  4345.  
  4346.  ┌─────────────────────────────────────────────────────────────────────┐
  4347.  │ OwnRecursive                                                        │
  4348.  └─────────────────────────────────────────────────────────────────────┘
  4349.  Usage : When you implement a  compressor, you have to tell MTA  if that
  4350.          compressor  is  capable  of  handling  recursive  support. This
  4351.          means that  the compressor  will look  in the  current and  all
  4352.          lower directories. If the customized compressor can not  handle
  4353.          recursive support, you must leave out this option out.
  4354.  
  4355.  Relate: All Own-options
  4356.  Dest. : OWN
  4357.  
  4358.  
  4359.  3.3.7 Statements that define the various exits (hooks) in MTA
  4360.  ───────────────────────────────────────────────────────────────────────
  4361.  The following statements can be used  to define one or more exits.  The
  4362.  exit points in MTA  can be used to  call other programs, before,  while
  4363.  or after  the compression  and/or start  and end  of MTA.  Some of  the
  4364.  exits like the  VirusScanner option are  advised, the others  are up to
  4365.  you !
  4366.  
  4367.  ┌─────────────────────────────────────────────────────────────────────┐
  4368.  │ VirusScanner [desc] [crt] [swap] [lowe] {highe} [path] [parm] {parm}│
  4369.  └─────────────────────────────────────────────────────────────────────┘
  4370.  Usage : One of the major topics  on the PC today is the virus.  MTA has
  4371.          specific support for the scan  for a virus. The scanning  (when
  4372.          active) is done  after the decompression  of the files  (before
  4373.          the removal of any files that match any ExcludeFile option).
  4374.  
  4375.          Which scanner(s) you want  to use is fully  up to you. MTA  can
  4376.          support  a  wide  range  of  scanners.  MTA  is tested with the
  4377.          following scanners  (examples for  their calls  are included in
  4378.          the sample MTA.CTL inside the distribution archive):
  4379.  
  4380.          - Scan     by McAfee <tm>
  4381.          - TBScan   by Frans Veldman <tm>
  4382.          - HTScan   by Harry Thijssen <tm>
  4383.          - VIRX     by Microcom Software Division <tm>
  4384.          - CPAV     by Central Point Software <tm> (Version 1.2 and up)
  4385.          - FINDVIRU by S&S International <tm> (Dr. Solomon)
  4386.  
  4387.          With  the  current   version  of  MTA,   up to 10 scanners  can
  4388.          be  included.  If  a  file  contains   a  virus, the archive is
  4389.          moved to  the error-directory  and marked  with special  0-byte
  4390.          files.  Also  further processing of  THIS file   is aborted and
  4391.          MTA will  start working on the next archive.
  4392.  
  4393.          [desc]        This must  be a  short description of the type of
  4394.                        scanner. It will be displayed in the MTA log-file
  4395.                        and  remote  when  MTA is  doing its work under a
  4396.                        protocol  driver like FileDoor <tm>. It can be up
  4397.                        to 40 bytes  and  spaces  must  be substituded by
  4398.                        underscore characters ('_');
  4399.  
  4400.          [crt]         You must  either supply   'B' or  'D'. If     the
  4401.                        scanner is BIOS  oriented (line-mode) and  can be
  4402.                        run in the  MTA window, you  can use 'B'.  If the
  4403.                        scanner is using direct video calls/running  full
  4404.                        screen, you  must supply  'D'. MTA  will preserve
  4405.                        the screen according to this option;
  4406.  
  4407.          [swap]        This must  be the  amount of  memory (in  Kbytes)
  4408.                        that  must  be  available  to  run  the   scanner
  4409.                        without MTA having to swap itself out of  memory.
  4410.                        The  examples  in  the  supplied MTA.CTL are good
  4411.                        ones and used while testing;
  4412.  
  4413.          [lowe]        This must be the errorlevel the scanner   returns
  4414.                        when  a  virus  is  found.  Most scanners use the
  4415.                        errorlevel 1 when a virus is found, some of  them
  4416.                        use  a  range.  Check  the  documentation  of the
  4417.                        scanner to make sure you supply the right  level.
  4418.                        The  examples  in  MTA.CTL  are  correct  for the
  4419.                        given scanners;
  4420.  
  4421.          {highe}       This parameter is optional. If the scanner   will
  4422.                        return a  range of  errorlevels when  a virus  is
  4423.                        involved  (HTScan  does),  you  must  supply  the
  4424.                        lower limit  in [lowe]  and the  higher limit  in
  4425.                        {highe}.   If you  don't supply  {highe}, it will
  4426.                        be set  to the  same value  as [lowe].  The given
  4427.                        examples  in  MTA.CTL  are  correct for the given
  4428.                        scanners;
  4429.  
  4430.          [Path]        This parameter must contain the drive,  directory
  4431.                        and  filename  of  the  scanner  in question. MTA
  4432.                        will  validate  if  the  program  is at the given
  4433.                        location and give a warning if it isn't;
  4434.  
  4435.          [parm] {parm} At  this  location   you  can  (must) supply  the
  4436.                        various parameters for  the scanner. There  are a
  4437.                        few macros  available  that  will  be replaced by
  4438.                        values at run-time. These are:
  4439.                        %P This macro will be replaced with the full name
  4440.                           of the HIGHEST directory in the tree where the
  4441.                           decompressed files reside;
  4442.                        %F Will do the same but  will  show a \*.* behind
  4443.                           the directory;
  4444.                        %D This macro will be replaced with the LAST node
  4445.                           in the directory  tree.  For  example, if  the
  4446.                           directory is E:\TUP\TST\1F6566A6, %D  will  be
  4447.                           replaced by 1F6566A6. This comes in handy  for
  4448.                           scanners that make problems in networks;
  4449.                        %L This macro will be replaced by the driveletter
  4450.                           and a colon (C:, E: and so on). Some  scanners
  4451.                           can only work on drives and not on directories
  4452.                           only;
  4453.                        %S This is a better replacement for %L.  It  will
  4454.                           be subtituded with the driveletter (and colon)
  4455.                           of the SUBSTituted drive (only  when  you  use
  4456.                           the SUBST support,  which  is  advised).  Only
  4457.                           when the scanner has  problems  with  a  SUBST
  4458.                           drive you should use %L. If you don't use  the
  4459.                           SUBST support of MTA, %S will be replaced with
  4460.                           the normal drive (as with %L);
  4461.  
  4462.          Never forget to  check if the  scanner will halt  for a prompt.
  4463.          If this is the  case and you run  unattended, you could have  a
  4464.          problem. If you  run attended, this  makes no difference.  Most
  4465.          scanners implement  a type  of 'No-prompt'  mode, like /NOPAUSE
  4466.          with SCAN.  Be sure  to set  it somewhere  in [parm] or {parm}.
  4467.          Also do not forget to  implement the option to check  ALL lower
  4468.          trees  under  the  directory  that  is tested. The scanner must
  4469.          also scan all sub-directories.
  4470.  
  4471.          Examples for the mentioned  scanners are included (and  tested)
  4472.          in the example MTA.CTL in the distribution archive.
  4473.  
  4474.  Relate: VirusMasks
  4475.  Dest. : All
  4476.  
  4477.  
  4478.  ┌─────────────────────────────────────────────────────────────────────┐
  4479.  │ VirusMasks [mask1] {mask2}..{mask10}                                │
  4480.  └─────────────────────────────────────────────────────────────────────┘
  4481.  Usage : Normally when you supply one or  more VirusScanner options, MTA
  4482.          will ALWAYS call all  virus-scanners for every  archive that is
  4483.          converted. This can be a pain in the neck when you have lots of
  4484.          files that don't contain  files that can carry a virus. If this
  4485.          is the case, or you want  to limit the testing of viri for some
  4486.          other reason, you  can  supply this VirusMasks option. With the
  4487.          option you can  supply  1 to 10 different file-masks. If one or
  4488.          more of  these  file-masks  match files inside the archive that
  4489.          is converted, MTA  will  call the virus-scanners. If no file in
  4490.          the archive matches  any of the masks that you supply with this
  4491.          option, the virus-scanners are NOT called !
  4492.  
  4493.          [mask1]       This parameter must be a valid file-mask. You can
  4494.            \\          also use the DISP-compatible format (=value). You
  4495.          {mask10}      must supply at  least  one mask when you use this
  4496.                        option and  you  can supply to a maximum of 10 of
  4497.                        these masks. In  normal  situations you will only
  4498.                        supply  extensions  like (*.COM, *.EXE, *.OVR and
  4499.                        *.SYS)  but  it  IS  possible to trigger the scan
  4500.                        on a full file-mask (like AVIRUS.COM).
  4501.  
  4502.          When you do NOT supply this option but you have supplied one or
  4503.          more  VirusScanner  options, the scan is ALWAYS performed. Only
  4504.          when the VirusMasks option is present, the scan will be limited
  4505.          to those archives that contain one or more match !
  4506.  
  4507.  Relate: VirusScanner
  4508.  Dest. : All
  4509.  
  4510.  
  4511.  ┌─────────────────────────────────────────────────────────────────────┐
  4512.  │ EXITBeforeStart       {dynswapsiz} [path] {option}...{option}       │
  4513.  │ EXITBeforeEnd         {dynswapsiz} [path] {option}...{option}       │
  4514.  │ EXITBetweenConversion {dynswapsiz} [path] {option}...{option}       │
  4515.  │ EXITAfterCompression  {dynswapsiz} [path] {option}...{option}       │
  4516.  │ EXITBeforeFill        {dynswapsiz} [path] {option}...{option}       │
  4517.  │ EXITAfterFill         {dynswapsiz} [path] {option}...{option}       │
  4518.  └─────────────────────────────────────────────────────────────────────┘
  4519.  Usage : These options  include the  support for  various user exits  at
  4520.          various  places  in  MTA.  You   can  instruct  MTA  to call  a
  4521.          program OR a batch-file  (normally batch-files are not  allowed
  4522.          but  they  are  for   these  exits).   All  options  have these
  4523.          parameters in common:
  4524.  
  4525.          {dynswapsiz]} This  can  be  the  amount of memory (in  Kbytes)
  4526.                        that  must  be  available  to  run  the   scanner
  4527.                        without MTA having to swap itself out of  memory.
  4528.                        You  can  also  leave   out  the  parameter   (no
  4529.                        swapping);
  4530.  
  4531.          [Path]        This parameter must contain the drive,  directory
  4532.                        and filename  of the  exit in  question. MTA will
  4533.                        not validate  if they  are present  but will fail
  4534.                        the exit (but continue) if they are not. You  can
  4535.                        either supply a program or a batch-file.
  4536.  
  4537.          {option}      You can include various parameters that  will  be
  4538.                        passed  to  the  called  program/batch over here.
  4539.                        For some  options there  are special  macros (see
  4540.                        below) that can be used.
  4541.  
  4542.          Some of the exits can  contain macros inside the {option}  part
  4543.          of the call, these are:
  4544.  
  4545.          %1   This parameter can  occur anywhere in  {option}. MTA  will
  4546.               substitute  this  parameter  with  the relative path where
  4547.               the  uncompressed  files  are.  This  parameter is in fact
  4548.               superfluous, because  you ARE  in this  directory when the
  4549.               call  to   the  exit   is  made   (only  valid   for   the
  4550.               ExitBetweenConversion and ExitAfterCompression exits);
  4551.  
  4552.          %2   MTA will substitute this parameter with the name (not  the
  4553.               extension) of  the compressed  file (to  be) created (only
  4554.               valid     for      the      ExitBetweenConversion      and
  4555.               ExitAfterCompression exits);
  4556.  
  4557.          %3   MTA will  substitute this  parameter with  the   extension
  4558.               (without  the  point,  so  LZH   and  not  .LZH)  of   the
  4559.               compressed file (to be) created.  Can be used to test  the
  4560.               target  type  in  most  situations  (only  valid  for  the
  4561.               ExitBetweenConversion and ExitAfterCompression exits);
  4562.  
  4563.          %T   MTA will substitute this parameter with the number of  the
  4564.               MTA-task (see  /TASK) that  is running.  When no  /TASK is
  4565.               supplied, %T  will be  replaced by  1. This  macro can  be
  4566.               used to assign different exits for different tasks;
  4567.  
  4568.          You can take  a look into  the supplied example  of batch-files
  4569.          that are present inside the distribution archive.
  4570.  
  4571.          The various exits are called in the following phases:
  4572.  
  4573.          ExitBeforeStart              Called once, after reading     the
  4574.                                       MTA.CTL   file   and   before  the
  4575.                                       actual conversion. Can be used  to
  4576.                                       (re)set the cache  (if any) or  to
  4577.                                       sort directories and so on;
  4578.  
  4579.          ExitBeforeEnd                Called once, after the  conversion
  4580.                                       and  just  before  the termination
  4581.                                       of  MTA.  Can  be  used to reverse
  4582.                                       the actions in ExitBeforeStart  or
  4583.                                       anything else;
  4584.  
  4585.          ExitBetweenConversion        Called after every decompress  and
  4586.                                       before the  actual compress  takes
  4587.                                       place.  Can  be  used  to  perform
  4588.                                       special     actions     on     the
  4589.                                       decompressed files that MTA  can't
  4590.                                       do for you;
  4591.  
  4592.          ExitAfterCompression         Called after every final  compress
  4593.                                       of a file. Can be used to  perform
  4594.                                       actions  on  the  new archive that
  4595.                                       MTA can't do;
  4596.  
  4597.          ExitBeforeFill               Only called when /D is used.   Can
  4598.                                       be used to  do something with  the
  4599.                                       empty  diskette  that  is going to
  4600.                                       be filled  with files.  An example
  4601.                                       is to (re)format such a  diskette.
  4602.                                       Exit   is    called   for    every
  4603.                                       converted diskette;
  4604.  
  4605.          ExitAfterFill                Only called when /D is used.   Can
  4606.                                       be used to  do something with  the
  4607.                                       newly filled diskette. An  example
  4608.                                       is to catalogue  all files on  the
  4609.                                       diskette   with   your    favorite
  4610.                                       catalogue program. Exit is  called
  4611.                                       for every converted diskette;
  4612.  
  4613.          As said before, there  are some example batch-files  inside the
  4614.          distribution archive.
  4615.  
  4616.  Relate: All of MTA
  4617.  Dest. : Any
  4618.  
  4619.  
  4620.  
  4621.  3.3.8 Statements that are useful to Bulletin Board Systems and SysOps
  4622.  ───────────────────────────────────────────────────────────────────────
  4623.  MTA can  be useful  for normal  user and  also for  SysOp's of Bulletin
  4624.  Board Systems (BBS). There are  several options that involve the  daily
  4625.  operation of archives inside a BBS.
  4626.  
  4627.  ┌─────────────────────────────────────────────────────────────────────┐
  4628.  │ BBSPaths [BBSType] [area-file] {alt-FBBS}                           │
  4629.  └─────────────────────────────────────────────────────────────────────┘
  4630.  Usage : If you change your file  areas once in a while, you can  decide
  4631.          to  use  another  source  for   MTA  than  the  usage  of   the
  4632.          DefaultPath option.  If you  use the BBSPaths option, MTA  will
  4633.          start the  conversion on  all directories  inside the area-file
  4634.          that you  assign. This  is only  useful when  you make usage of
  4635.          AMS  (the  MarkString/NoMarked  options)  or  the  OnlyNewFiles
  4636.          option.   The BBSPaths  option is  meant for  a large number of
  4637.          QuickBBS  <tm>  compatible  BBS's  (clones)  like Remote Access
  4638.          <tm>, SuperBBS <tm> and  certainly QuickBBS <tm> itself  in all
  4639.          various flavors.
  4640.  
  4641.          [BBSType]     With  this  parameter you  assign the type of BBS
  4642.                        that  created the area-file (f.i. FLSEARCH.BBS or
  4643.                        FILES.RA) that MTA will use. The following values
  4644.                        are currently supported:
  4645.  
  4646.                        SBBS :  SuperBBS  <tm>  versions 1.16 and  higher
  4647.                               (FLSEARCH.BBS)
  4648.  
  4649.                        QOLD : QuickBBS  <tm>   versions  2.74 and  lower
  4650.                               (FLSEARCH.CTL)
  4651.  
  4652.                        QBBS : QuickBBS   <tm>  versions 2.75  and higher
  4653.                               (FILECFG.DAT)
  4654.  
  4655.                        MAXI : Maximus    <tm>  versions 2.xx  and higher
  4656.                               (AREAS.DAT)
  4657.  
  4658.                        RA00 : Remote   Access   <tm>   versions     0.0x
  4659.                               (FILES.RA)
  4660.  
  4661.                        RA10 : Remote   Access  <tm> versions  1.0x, uses
  4662.                               (FILES.RA)
  4663.  
  4664.                        RA11 : Remote   Access  <tm> versions  1.1x, uses
  4665.                               FILES.RA  and  alternate  FILES.BBS  files
  4666.                               for CD-ROM
  4667.  
  4668.                        RA20 : Remote   Access  <tm> versions  2.0x, uses
  4669.                               FILES.RA  and  alternate  FILES.BBS  files
  4670.                               for CD-ROM
  4671.  
  4672.          [area-file]   This parameter must contain the drive,  directory
  4673.                        and  filename  of  the  BBS area-file.  MTA  will
  4674.                        validate  if  it  is   present.   The  file  must
  4675.                        follow the   standard   for the  type of  BBS you
  4676.                        choose in [BBSType] (some  have various  formats,
  4677.                        depending  on  the  version).  See  the   example
  4678.                        MTA.CTL file(s) for the correct file-names;
  4679.  
  4680.          {alt-FBBS}    When you  assign RA11 or RA20, you must  also use
  4681.                        this parameter. You assign the alternate dir  for
  4682.                        the  FILES.BBS  files  (FILES.1,  FILES.99 and so
  4683.                        on)  that  are  used  for  READ-ONLY devices like
  4684.                        CD-ROM.  For all other BBS-types, this  parameter
  4685.                        has no meaning.
  4686.  
  4687.  
  4688.          Depending on the type of BBS,  MTA will work on all areas  that
  4689.          are inside the  BBS area-file. Some  BBS's show the  difference
  4690.          between  normal  areas  and  READ-ONLY  areas (like CD-ROM). In
  4691.          that case, MTA will also know the difference and will NOT  work
  4692.          on these areas (it is  impossible to write on these  media, nor
  4693.          to move any vaulty archives from these media). BBS's that  have
  4694.          CD-ROM access are, RA (1.xx  and higher, by means of  alternate
  4695.          FILES.nnn files that must  be present in a  special directory),
  4696.          SBBS  (inside   the  FLSEARCH.BBS,   when  the   file-path  and
  4697.          list-path are not equal) and QuickBBS 2.75 (same as SBBS).
  4698.  
  4699.          MTA will *ADD* all the  valid directories from BBSPaths to  the
  4700.          already present directories that can come from Defaultpath  and
  4701.          will also look  at  the  ExcludeDirectory  option  to see which
  4702.          directories must  be  left  out. MTA is able to store up to 255
  4703.          directories in memory. If there are more directories inside the
  4704.          area-file, MTA will abort (this will be changed very soon).
  4705.  
  4706.  Relate: DefaultPath, ExcludeDirectory
  4707.  Dest. : All
  4708.  
  4709.  
  4710.  ┌─────────────────────────────────────────────────────────────────────┐
  4711.  │ ExcludeDirectory [dir]                                              │
  4712.  └─────────────────────────────────────────────────────────────────────┘
  4713.  Usage : This option is mainly used when you want to exclude one or more
  4714.          (up to 255) directories from the directories that are collected
  4715. │        by the  BBSPaths option.  If  one  or  more  of the directories
  4716. │        inside the BBS contain abnormal archives (f.i. other platforms)
  4717.          you can exclude  such  directory  to  overcome the problem that
  4718.          otherwise  would occur when MTA starts converting these files !
  4719.  
  4720.          [dir]         This value must point to a valid  drive/directory
  4721.                        which will be excluded  from  the BBSPaths option
  4722.                        (even from DefaultPath, but this  has  no  useful
  4723.                        meaning).
  4724.  
  4725. │Relate: DefaultPath, BBSPaths
  4726.  Dest. : All
  4727.  
  4728.  ┌─────────────────────────────────────────────────────────────────────┐
  4729.  │ CarryComment [type] {comment}                                       │
  4730.  └─────────────────────────────────────────────────────────────────────┘
  4731.  Usage : This option is  another way of putting (useful)  comment inside
  4732.          the  target  archives.  There  are  various  in  which way this
  4733.          option can work, but only one is allowed. You can overrule  the
  4734.          type of work with the /CARCOM command-line option though.
  4735.  
  4736.          With CarryComment you order MTA to carry over any comment  from
  4737.          the source  archive (PAK/ZIP/ARJ/ZOO)  into the  target archive
  4738.          (same types). The carry can be done in three different ways.
  4739.  
  4740.          [type]        This  parameter can be set to 1, 2 or 3.  The way
  4741.                        CarryComment will work depends on the number  you
  4742.                        set  over  here.  The  values  have the following
  4743.                        meaning:
  4744.  
  4745.                        1 : MTA  will carry over  the comment (up  to 256
  4746.                            bytes) from the source file, if a comment  is
  4747.                            available;
  4748.  
  4749.                        2 : MTA will first look into the source file  and
  4750.                            will remember up to 256 bytes of the  comment
  4751.                            (if any).   After conversion,  MTA will  look
  4752.                            into the  file you  supplied in  the FilesBBS
  4753.                            option (if  you did  supply this  option). If
  4754.                            the file  has a  record inside  the FILES.BBS
  4755.                            (or alike  file), THIS  comment is  taken and
  4756.                            not the comment  in the source  file.  If  no
  4757.                            comment  is  available,  MTA  will  use   the
  4758.                            comment from the source file (if any);
  4759.  
  4760.                        3 : MTA will  always look into the  FILES.BBS (or
  4761.                            alike) file. This is only valid when you  use
  4762.                            the  FilesBBS   option.  If   a  record    is
  4763.                            available,  the  comment  is  carried over to
  4764.                            the target  file. If  no record  is available
  4765.                            the target will NOT have any comment;
  4766.  
  4767.          {comment}     When you supply this  parameter (spaces must   be
  4768.                        replaced  with  underscore  characters), MTA will
  4769.                        put this  comment IN  FRONT of  the comment  that
  4770.                        came from the carry itself. There will be a  CRLF
  4771.                        between this comment and the following  (carried)
  4772.                        comment.
  4773.  
  4774.          You can make a combination  of the AutoComment and the  current
  4775.          option (CarryComment). In  this case, MTA  will add a  combined
  4776.          into  the  target-file.  In  the  combination, the comment from
  4777.          AutoComment file  comes first  and the  comment constructed  by
  4778.          the  CarryComment  statement  comes  directly  (WITHOUT A CRLF)
  4779.          after this comment. Please keep  in mind that you separate  the
  4780.          two comments yourself (if needed) by adding a CRLF in the  file
  4781.          assigned by AutoComment.
  4782.  
  4783.          Please  also  read  the  info  on  the  FilesBBS option and the
  4784.          AddFilesBBS option.
  4785.  
  4786.  Relate: FilesBBS, AddFilesBBS
  4787.  Source: ZIP/PAK/ZOO/ARJ
  4788.  Dest. : ZIP/PAK/ZOO/ARJ
  4789.  
  4790.  
  4791.  ┌─────────────────────────────────────────────────────────────────────┐
  4792.  │ FILEIDDIZ {name1} {name2} {name3} {name4} {name5}                   │
  4793.  └─────────────────────────────────────────────────────────────────────┘
  4794.  Usage : For  some  BBS   programs,  the file FILE_ID.DIZ has a  special
  4795.          meaning.  It  contains  a  description  of the programs (files)
  4796.          that are included inside the  archive. MTA can do a  few things
  4797.          with  this  comment.  If  you  use this option (FILEIDDIZ), you
  4798.          instruct MTA to  store the text  from FILE_ID.DIZ into  memory.
  4799.          This  is  done, only  when  the  archive  actually  contains  a
  4800.          FILE_ID.DIZ file (or name-like, see parameters).
  4801.  
  4802.          You can also instruct MTA to search for other files that have
  4803.          the same usage as FILE_ID.DIZ. In some distribution nets, the
  4804.          author can create two files, one containing 'high' characters
  4805.          and one containing only characters in the range X'00'-X'127'.
  4806.          Other types of files will also be used for sure, so MTA is very
  4807.          'dynamic' in the usage of this option.
  4808.  
  4809.          {name1}       Normally MTA will  look for files with the   name
  4810.            //          FILE_ID.DIZ. If this is not the correct  standard
  4811.          {name5}       on  your  system,  MTA   can   look for (an)other
  4812.                        file(s) with such usage but  with different names.
  4813.                        MTA will  use  the  priority in the way you order
  4814.                        the different names. If you use A B C D and E for
  4815.                        {name1} to {name5} and the  archive contains both
  4816.                        B and D, MTA  will  use B and will leave D alone.
  4817.                        If you use A D C B and E, MTA will use the D-file
  4818.                        because it comes first in the list. There  can be
  4819.                        a maximum of 5 different names !
  4820.  
  4821.          Previous versions of MTA were not so relaxed when the format of
  4822.          the FILE_ID.DIZ was  tested. There  is  no  actual standard for
  4823.          this file, though the original distribution-net used files with
  4824.          8 lines, each containing  43  bytes of text (FILES.BBS format).
  4825.          MTA would give a warning when more (or less) lines were present
  4826.          and the lines exceeded the 43  byte bounds. Because of the more
  4827.          dynamic usage (not only  FILE_ID.DIZ can be used), MTA will now
  4828.          store up to 20 lines  of  (up to) 128 bytes of text without any
  4829.          warning.
  4830.  
  4831.          This option  (on its  own) will  not do  more than  reading the
  4832.          file FILE_ID.DIZ  (or the names you  supplied) and  storing the
  4833.          information  in  memory.  What  is  going  to  happen with this
  4834.          informations is  depending on  the FilesBBS/AddFILESBBS  option
  4835.          and/or the StoreComment and ReplaceComment option).
  4836.  
  4837.  
  4838.  Relate: FilesBBS/AddFilesBBS, StoreComment, ReplaceComment
  4839.  Source: All
  4840.  Dest. : All
  4841.  
  4842.  
  4843.  ┌─────────────────────────────────────────────────────────────────────┐
  4844.  │ LeadingSpace TRIM                                                   │
  4845.  │ LeadingSpace CHAR [char]                                            │
  4846.  └─────────────────────────────────────────────────────────────────────┘
  4847.  Usage : This  is  a very  special option that can be used when you work
  4848.          with special door-programs that list your FILES.BBS-alike files
  4849.          in a non-conventional way.
  4850.  
  4851.          When MTA  obtains  information  from the FILE_ID.DIZ (or alike)
  4852.          files  and  this  comments  contains spaces at the beginning of
  4853.          the second (or higher) line, like:
  4854.  
  4855.          This file description has a special format because
  4856.              - It contains spaces at the start of this line
  4857.              - And again
  4858.              - And again
  4859.  
  4860.          it will keep this spaces (by default), resulting in entries  in
  4861.          the FILES.BBS-alike file, that look like this:
  4862.  
  4863.          ffffffff.eee This file description has a special format because
  4864.           +    - It contains spaces at the start of this line
  4865.           +    - And again
  4866.           +    - And again
  4867.  
  4868.          Some  door-programs  that list  FILES.BBS-alike files with this
  4869.          format, will  display  these lines with a bad adjustment on the
  4870.          screen. To overcome  this  problem, you can use LEADINGSPACE to
  4871.          convert the descriptions.
  4872.  
  4873.          TRIM  :  When TRIM  is used, MTA  will strip all leading spaces
  4874.                   from the comment and will add the '+' before the first
  4875.                   non-space character;
  4876.  
  4877.          CHAR  :  When CHAR is used, MTA will replace all leading spaces
  4878.                   with the  character  [char]. [char] can  be coded as a
  4879.                   single  character (like 'Leadingspace #', resulting in
  4880.                   the replacement  of each leading space into '#') or as
  4881.                   a 3-digit  number (like 'Leadingspace 225',  resulting
  4882.                   in the  replacement  of  each leading  space into 'ß').
  4883.                   The number must be decimal !
  4884.  
  4885.  Relate: FILEIDDIZ, ADDFILESBBS
  4886.  Dest. : All
  4887.  
  4888.  
  4889.  ┌─────────────────────────────────────────────────────────────────────┐
  4890.  │ ReplaceComment                                                      │
  4891.  └─────────────────────────────────────────────────────────────────────┘
  4892.  Usage : When you use the FILEIDDIZ parameter, MTA can add new comments
  4893.          to FILES.BBS that come from this file (see FILEIDDIZ option).
  4894.          Normally, MTA will not REPLACE a comment in FILES.BBS with the
  4895.          comment taken from this file. This could cause much harm to all
  4896.          your FILES.BBS files when you (re)convert a complete area of
  4897.          files. All you modified comments would be removed when a file
  4898.          contains a FILE_ID.DIZ-alike file.
  4899.  
  4900.          If you want to replace existing comments in FILES.BBS with the
  4901.          comment that comes from a FILE_ID.DIZ-alike file that is  read
  4902.          when the file  in  question  is converted, you can supply this
  4903.          option but be  careful. For  starters,  MTA remove the comment
  4904.          somewhere in the  FILES.BBS  and  will  add the new comment to
  4905.          the end of the  FILES.BBS. Also,  carefully  created  comments
  4906.          with nice  bells  and  whistles are replaced by something that
  4907.          indeed covers the file-description but is always very simple !
  4908.  
  4909.  Relate: FilesBBS/AddFilesBBS, FILEIDDiz
  4910.  Source: All
  4911.  Dest. : All
  4912.  
  4913.  
  4914.  ┌─────────────────────────────────────────────────────────────────────┐
  4915.  │ DefFilesBBSDesc [mask] [desc]                                       │
  4916.  └─────────────────────────────────────────────────────────────────────┘
  4917.  Usage : When MTA has to add the converted file to the FILES.BBS (alike)
  4918.          file and there  is  NO  comment taken from ANY location (any of
  4919.          the FILE_ID.DIZ-alike files and/or previous FILES.BBS entries),
  4920.          MTA will  (by default)  add  'No description available' as  the
  4921.          comment  inside the  FILES.BBS-alike file. Previous versions of
  4922.          MTA would  even only  add the  filename (and no comment) to the
  4923.          FILES.BBS-alike file when the archive was NEW.
  4924.  
  4925.          MTA  will  now,  by default, put  'No description available' in
  4926.          the  FILES.BBS-alike file. This will be the case if NO previous
  4927.          description  is  available (FILE_ID.DIZ, FILES.BBS)  and/or the
  4928.          archive is NEW.
  4929.  
  4930.          BEFORE MTA  will  add 'No description available', MTA will scan
  4931.          all available DefFILESBBSDesc options in MTA.CTL. These options
  4932.          (up to 255 are allowed) have two parameters:
  4933.  
  4934.          [mask]        This must  be a valid DOS, 4Dos <tm> or DISP <tm>
  4935.                        filename  mask  (wildcards allowed). There are no
  4936.                        directories allowed;
  4937.  
  4938.          [desc]        This must  be the description that belongs to the
  4939.                        previous  [mask]. It  can  be  up to 47 byte long
  4940.                        and spaces are allowed.
  4941.  
  4942.          If MTA can  match  the filename with a mask, the comment of the
  4943.          FIRST match  is  carried  over  into  the FILES.BBS-alike file.
  4944.          You can also use  this option to change the default comment for
  4945.          ALL files.
  4946.  
  4947.          An example:
  4948.  
  4949.          DefFilesBBSDesc NODELIST.*   The new nodelist file
  4950.          DefFilesBBSDesc NODEDIFF.*   The new nodelist difference file
  4951.          DefFilesBBSDesc NODE*.*      Something to do with the nodelist
  4952.          DefFilesBBSDesc *.LU         ARRRG, who uses LU these days ?
  4953.          DefFilesBBSDesc *.*          No description found, sorry !
  4954.  
  4955.          The following files will give the following results:
  4956.  
  4957.          NODELIST.A26    Decription : The new nodelist file
  4958.          NODESHIT.A88                 Something to do with the nodelist
  4959.          NADASHIT.Z12                 No description found, sorry !
  4960.          BAR.LU                       ARRRG, who uses LU these days ?
  4961.          FOOBAR.ZOO                   No description found, sorry !
  4962.  
  4963.  Relate: FilesBBS/AddFilesBBS, FILEIDDiz, CarryComment
  4964.  Source: All
  4965.  
  4966.  
  4967.  ┌─────────────────────────────────────────────────────────────────────┐
  4968.  │ FilesBBS {location}                                                 │
  4969.  └─────────────────────────────────────────────────────────────────────┘
  4970.  Usage : If you convert files, the name will change in most cases  (from
  4971.          the source system, fi.  A.ZIP, to the destination,  fi. A.LZH).
  4972.          This change will  cause any entry  in the FILES.BBS  alike file
  4973.          to be  invalid. MTA  can help  out in  this case.  When you add
  4974.          this  option,  the  entries  in  the  FILES.BBS  alike file (if
  4975.          available) will also change !
  4976.  
  4977.          There are several  formats of this  option. If coded  without a
  4978.          parameter, MTA will  assume FILES.BBS as  the filename and  the
  4979.          directory where the conversion  takes place as the  location of
  4980.          the file.
  4981.  
  4982.          {location}    This parameter is optional an can either contain:
  4983.  
  4984.                        - A filename. In  this case MTA will  assume this
  4985.                          filename  as  the  name  of the FILES.BBS alike
  4986.                          file  and  the  directory  where the conversion
  4987.                          takes place as the location;
  4988.  
  4989.                        - A  full path,  containing drive,  directory and
  4990.                          filename. In  this case,  MTA will  assume that
  4991.                          you only  have ONE  FILES.BBS alike  file (this
  4992.                          is the case  for RBBS-alike systems).  The name
  4993.                          and location are assigned with this parameter.
  4994.  
  4995.          When you don't use  the FilesBBSFormat option (see  later), MTA
  4996.          will search  for filenames  in position  1 of  each record  and
  4997.          with the format FILENAME.EXT (upper- and lower case).   Changes
  4998.          are  made  after  every  conversion.   If  MTA  aborts  on   an
  4999.          operation,  all  PREVIOUS  archives  that  are  converted   ARE
  5000.          already changed in the FILES.BBS alike file(s).
  5001.  
  5002.          If you run  the ExitAfterCompression to  create SFX files  from
  5003.          the target  archives, the  change in  the FILES.BBS  alike file
  5004.          will  be   incorrect  !   You  must   use  one   of  the    MTA
  5005.          CompressionType values that instruct MTA to create the SFX.  In
  5006.          this case the change will be done correctly !
  5007.  
  5008.          It is also possible to change any sizes in the FILES.BBS  alike
  5009.          file(s). Some  of these  files contain  the actual  size of the
  5010.          file (RBBS master  directory). MTA will  change the size  also,
  5011.          if the correct size was already present in the FILES.BBS  alike
  5012.          file.
  5013.  
  5014.          If comments in the FILES.BBS  alike file start with a  download
  5015.          counter (e.g. FILENAME.EXT [01]  Downloaded once), and you  use
  5016.          the CarryComment  option (types  2 or  3), MTA  will strip  the
  5017.          download-counter  (only  when  the  format  is [nnnn]) from the
  5018.          description  that  will  be  added  to  the archive (not in the
  5019.          FILES.BBS alike file).
  5020.  
  5021.          This option  can also  be used  in a  NON-BBS environment where
  5022.          4Dos is installed and used. You should set the various  options
  5023.          as follows:
  5024.  
  5025.          - Set the FilesBBS option       to 'FilesBBS DESCRIPT.ION';
  5026.          - Set the FilesBBSFormat option to 'FilesBBSFormat 1 1 I2';
  5027.          - Set the AddFilesBBS option;
  5028.          - Set the CarryComment option to 2 (without extra parameters);
  5029.  
  5030.          In this case the comment will  be carried over out of the  4Dos
  5031.          DESCRIPT.ION file (this  is a hidden  file that 4DOS  maintains
  5032.          when you  use the  DESCRIBE command),  the change  of extension
  5033.          (if any) will be performed in the same file and if there is  no
  5034.          comment for this file in  the DESCRIPT.ION file, MTA can  carry
  5035.          over the comment from the archive (if any) into this file.
  5036.  
  5037.          When the FilesBBS option is active and MTA detects a  defective
  5038.          archive, MTA will move  this archive to the  supplied directory
  5039.          for  archives  in  error.  MTA  will also carry the description
  5040.          from the original FILES.BBS alike file over to a new  FILES.BBS
  5041.          alike file in this error directory.  The original comment  will
  5042.          ALSO  stay  in  the  original  FILES.BBS  alike  file. When the
  5043.          FILES.BBS alike  file is  on a  fixed location,  this option is
  5044.          not triggered.
  5045.  
  5046.  Relate: FilesBBSFormat
  5047.  Dest. : All
  5048.  
  5049.  
  5050.  ┌─────────────────────────────────────────────────────────────────────┐
  5051.  │ AddFilesBBS                                                         │
  5052.  └─────────────────────────────────────────────────────────────────────┘
  5053.  Usage : If you receive new  files without any entries in the  FILES.BBS
  5054.          alike file,  MTA can  add them  for you.  If the source archive
  5055.          also contains a  description (comment), this  is also added  to
  5056.          that file. The AddFilesBBS  option will ONLY function  when you
  5057.          have  set  the  FilesBBS  option.  The description will only be
  5058.          added (if present) when the  CarryComment option is set with  a
  5059.          value of 1 or 2. The format of the added record is the same  as
  5060.          set in the FilesBBSFormat option.
  5061.  
  5062.          If you have set the FILEIDDIZ option AND there is such a file
  5063.          inside the archive, MTA will use THIS comment (it has a higher
  5064.          priority than CarryComment) for the new entry in the FILES.BBS
  5065.          alike file. If there already IS a comment in the FILES.BBS
  5066.          alike file (for this file), MTA will NOT overwrite that comment
  5067.          with the new comment.
  5068.  
  5069.          If MTA  is unable to obtain comments from the FILEIDDIZ option,
  5070.          it will also search in any DESCRIPT.ION file (4Dos <tm> comment
  5071.          file) or in  any ?????????.I?? (FileDoor <tm> information file)
  5072.          file before searching in the DefFilesBBSDesc options !
  5073.  
  5074.  Relate: FilesBBSFormat, FilesBBS, CarryComment, FileIDDiz,
  5075.          DefFilesBBSDesc
  5076.  Dest. : All
  5077.  
  5078.  
  5079.  ┌─────────────────────────────────────────────────────────────────────┐
  5080.  │ FilesBBSFormat [name] [extension] [comment]                         │
  5081.  └─────────────────────────────────────────────────────────────────────┘
  5082.  Usage : This option will instruct MTA about the internal format of  the
  5083.          FILES.BBS alike  file.   Under default  conditions, MTA expects
  5084.          the  filename  to  start  on  position  1  of each line, with a
  5085.          filename format  for name.ext  (with a  point between  the name
  5086.          and the  extension) and  the comment  to start  on position 14.
  5087.          When your FILES.BBS alike file  (if you use any) is  different,
  5088.          you must use this option to set the new format.
  5089.  
  5090.          [name]        This parameter must be set to the position  where
  5091.                        the filename will start;
  5092.  
  5093.          [extension]   This parameter must be set to the position  where
  5094.                        the  extension  will  start.  If filename and the
  5095.                        extension  are  combined  together  with a point,
  5096.                        [name] and [extension] must be the same value;
  5097.  
  5098.          [comment]     This parameter must be the starting point of  the
  5099.                        comment.  If  the  FILES.BBS  alike file does not
  5100.                        contain a comment,  you must set  it to 255.   If
  5101.                        the comment 'floats'  somewhere in the  file, the
  5102.                        starting position  is different  every time,  you
  5103.                        can use another format.  In this case you  supply
  5104.                        the ITEM NUMBER  (and not the  starting position)
  5105.                        with the value 'I'. For example:
  5106.  
  5107.                        My.ZIP 1234 The comment
  5108.                        Our.ZIP 233222 The comment
  5109.  
  5110.                        In  this  case,  the  comment  is floating but is
  5111.                        always the 4th item.  In this case you  supply I4
  5112.                        for this parameter.
  5113.  
  5114.          The FilesBBSFormat option only has a meaning when the  FilesBBS
  5115.          option is also set.
  5116.  
  5117.  Relate: FilesBBS
  5118.  Dest. : All
  5119.  
  5120.  
  5121.  ┌─────────────────────────────────────────────────────────────────────┐
  5122.  │ FilesCounter [location] {startchar} {endchar}                       │
  5123.  └─────────────────────────────────────────────────────────────────────┘
  5124.  Usage : This  option  can  be used to instruct MTA how to recognize and
  5125.          use files-counters  in  the  FILES.BBS-alike file. MTA will use
  5126.          the information  to  strip files-counter from descriptions that
  5127.          are added as  comment  to the archive (CARRYCOMMENT option) and
  5128.          to add  files-counters  when  the  filenames are changed in the
  5129.          FILES.BBS-alike  files or  files are added to this file (if the
  5130.          ADDFILESBBS option is set).
  5131.  
  5132.          [location]    This is the  location of the files-counter in the
  5133.                        FILES.BBS-alike file. Valid values are:
  5134.  
  5135.                        NONE  : There  are  NO  files-counters set in the
  5136.                                FILES.BBS-alike  files (you don't use any
  5137.                                counters);
  5138.  
  5139.                        START : The  files-counters  are  placed  at  the
  5140.                                start of the comment;
  5141.  
  5142.                        END   : The files-counters  are placed at the end
  5143.                                of the comment;
  5144.  
  5145.          {startchar}   This  parameter  can  be  used to  tell MTA which
  5146.                        character  is  used as the starting character for
  5147.                        the files-counter (like '[', '{', '(' and so on).
  5148.                        By default MTA  assumes  the '[' character as the
  5149.                        start-character of the files-counter;
  5150.  
  5151.          {endchar}     This  parameter  can  be  used  to tell MTA which
  5152.                        character is used as the ending character for the
  5153.                        files-counter (like ']', '}', ')' and  so on). By
  5154.                        default MTA assumes the ']' character as the end-
  5155.                        character of the files-counter;
  5156.  
  5157.  
  5158.          When no FILESCOUNTER option is supplied, MTA will assume:
  5159.  
  5160.          FilesCounter START [ ]
  5161.  
  5162.          E.g. counters  at  the  start of the comment, starting with '['
  5163.          and ending with ']'. FILES.BBS-alike entries will look like:
  5164.  
  5165.          nnnnnnnn.eee [##] ccccccccccccccccccccccccccccccccccccccccc
  5166.  
  5167.          When you do not use any counters in your FILES.BBS-alike files,
  5168.          you have to set:
  5169.  
  5170.          FilesCounter NONE
  5171.  
  5172.  Relate: FilesBBS, AddFilesBBS, CarryComment
  5173.  Dest. : All
  5174.  
  5175.  
  5176.  ┌─────────────────────────────────────────────────────────────────────┐
  5177.  │ TICKFiles [mask]                                                    │
  5178.  │ FESFiles  [mask]                                                    │
  5179.  └─────────────────────────────────────────────────────────────────────┘
  5180.  Usage  :  Until  now,  all  previous  BBS-options had to do with normal
  5181.          FILES.BBS alike type of  files. The following options  do some-
  5182.          thing  with  other  types  of  files.   These  options makes it
  5183.          possible to pick  up the description  of a certain  file from a
  5184.          TICK or  FES file.  When you  get your  files into  the inbound
  5185.          directory and the *.TIC/FES files along with them, you can  now
  5186.          convert them (and  optionally move them)  to any other  system,
  5187.          while MTA will try to extract the comment of the file from  the
  5188.          associated TICK/FES-file. You can  do two types of  things with
  5189.          these  comments.  You  can  add  them  to  the  FILES.BBS   (if
  5190.          AddFILESBBS is set to on) AND you can store them in the  header
  5191.          of the archive (comment) when CarryComment is set to on.
  5192.  
  5193.          If CarryComment is on (independent  of the type 1,2 or  3), MTA
  5194.          will  search  for  the  comment  in the old archive-header, the
  5195.          FILES.BBS or  both. If  TICKFiles is  set   AND MTA  can find a
  5196.          description in any of the TICK-files, this comment will  always
  5197.          overrule the comment from the FILES.BBS or the old header.  The
  5198.          same goes for the FESFiles option.
  5199.  
  5200.          [mask]        This parameter must point to a drive,   directory
  5201.                        and  filemask.   Most  obvious   is  to   include
  5202.                        *.TIC as   the  filemask   (and  in   some  cases
  5203.                        *.BAD can also be handy).
  5204.  
  5205.          You  can  use  multiple  TICKFiles  options to assign different
  5206.          TICK files (*.TIC and *.BAD) and in different directories.   Up
  5207.          to  10  are  allowed.  Also  10  FESFiles  options  are allowed
  5208.          (*.FES, *.BAD).
  5209.  
  5210.          The  TICK/FES-files  are  ALL  searched  (for  every  converted
  5211.          archive) until either:
  5212.  
  5213.          - a description is found;
  5214.  
  5215.          - all files are processed and no description was found;
  5216.  
  5217.          MTA will  search for  either FILE:  or FILE  and DESC: and DESC
  5218.          inside the TICK-files. This is  pointed out in FSC-0028 !   The
  5219.          FES files follow the authors description !
  5220.  
  5221.  Relate: FilesBBS, AddFilesBBS, CarryComment
  5222.  Dest. : All
  5223.  
  5224.  
  5225.  ┌─────────────────────────────────────────────────────────────────────┐
  5226.  │ UpdateUntypedFiles [mask]                                           │
  5227.  └─────────────────────────────────────────────────────────────────────┘
  5228.  Usage : This is  a special, independent, option  to update any type  of
  5229.          file with the new (converted) name of the archive. Let us  take
  5230.          an example:
  5231.  
  5232.          -) Some  products keeps  a small  database with  names of files
  5233.             (also your archives) inside.   RFW is such an example.   Now
  5234.             you  convert  some  archive  and  the information inside the
  5235.             database has  become invalid  !   UpdateUntypedFiles is  the
  5236.             answer to your problem.
  5237.  
  5238.          UpdateUntypedFiles will update ANY type of file (even a program
  5239.          or binary file) with the new name of the archive IF:
  5240.  
  5241.          - You don't use the /D option;
  5242.  
  5243.          - The name  of the target  has the same  length as the  name of
  5244.            the source. A  conversion from something.ZIP  to Something.MD
  5245.            will not be performed;
  5246.  
  5247.          - The name location is  within the 64K (65535) bytes  bounds of
  5248.            the file;  Longer files  will NOT  be truncated  but only the
  5249.            first 64K of bytes are scanned and (optionally) changed;
  5250.  
  5251.          [mask]        This parameter must point to a drive,   directory
  5252.                        and filemask.
  5253.  
  5254.          You can add up to  10 UpdateUntypedFiles options into the  file
  5255.          MTA.CTL. But be smart and think before you do. MTA will  search
  5256.          ALL files and though  this is fast I/O,  it can take some  time
  5257.          if you include numerous files !
  5258.  
  5259.          UpdateUntypedFiles can be used  as a replacement to  the update
  5260.          of the  FILES.BBS alike  file(s) when  these files  are smaller
  5261.          than 64K.  In that  case, this  option will  give you a 50-200%
  5262.          gain in speed over the FilesBBS option !!.
  5263.  
  5264.  Relate: UpdateTICKFiles, UpdateFESFiles
  5265.  Dest. : All
  5266.  
  5267.  
  5268.  ┌─────────────────────────────────────────────────────────────────────┐
  5269.  │ UpdateUntypedFull                                                   │
  5270.  └─────────────────────────────────────────────────────────────────────┘
  5271.  Usage : This option can be used in combination with the previous option
  5272.          (UPDATEUNTYPEDFILES). If  this  option  is  set, MTA  will only
  5273.          change the filename  in  the  'untyped file'  when both the old
  5274.          filename AND the name of the directory both match the converted
  5275.          file.
  5276.  
  5277.          Without this option, MTA will only change the file when the old
  5278.          old filename matches but MTA won't look at the directoryname.
  5279.  
  5280.          You should  set  this option when you use UPDATEUNTYPEDFILES to
  5281.          update *.MSG files with attached files (TICK/FES support) !
  5282.  
  5283.  Relate: UpdateUntypedFiles
  5284.  Dest. : All
  5285.  
  5286.  
  5287.  ┌─────────────────────────────────────────────────────────────────────┐
  5288.  │ UpdateTICKFiles [mask]                                              │
  5289.  │ UpdateFESFiles  [mask]                                              │
  5290.  └─────────────────────────────────────────────────────────────────────┘
  5291.  Usage : The syntax  is the  same as  with UpdateUntypedfiles.  See  the
  5292.          chapter  about  TICK  files,  later  in this documentation. The
  5293.          material is to complex to put over here.
  5294.  
  5295.  Relate: UpdateUntypedFiles, UpdateMSGFiles
  5296.  Dest. : All
  5297.  
  5298.  
  5299.  ┌─────────────────────────────────────────────────────────────────────┐
  5300.  │ UpdateMSGFiles [dir]                                                │
  5301.  └─────────────────────────────────────────────────────────────────────┘
  5302.  Usage : The UPDATEMSGFILES option has a different format than the three
  5303.          previous options. There can be ut to 255 of these options with
  5304.          the following parameter:
  5305.  
  5306.          [dir]         This parameter must point to a ddirectory where
  5307.                        your *.MSG files are. Do not code the file-mask,
  5308.                        but ONLY the directory.
  5309.  
  5310.          See the chapter on TICK files for a description of this option.
  5311.  
  5312.  Relate: UpdateTICKFiles, UpdateFESFiles
  5313.  Dest. : All
  5314.  
  5315.  
  5316.  ┌─────────────────────────────────────────────────────────────────────┐
  5317.  │ UpdateMSGFull                                                       │
  5318.  └─────────────────────────────────────────────────────────────────────┘
  5319.  Usage : Same as the UPDATEUNTYPEDFULL  option  but now in relation with
  5320.          the UPDATEMSGFILES option.
  5321.  
  5322.          You  should  set  this  option  when  you use UPDATEMSGFILES to
  5323.          update *.MSG files with attached files (TICK/FES support) !
  5324.  
  5325.  Relate: UpdateMSGFiles
  5326.  Dest. : All
  5327.  
  5328.  
  5329.  ┌─────────────────────────────────────────────────────────────────────┐
  5330.  │ COMPort [port]                                                      │
  5331.  └─────────────────────────────────────────────────────────────────────┘
  5332.  Usage : MTA has internal modem support. This is needed in case you  run
  5333.          MTA as an exit of the  BBS (e.g. a protocol driver like  DISP's
  5334.          FileDoor). When you  use modem support,  MTA will echo  some of
  5335.          the progress to the COM-port and the user can follow a part  of
  5336.          the  conversion.  All  modem  related  options  will do NOTHING
  5337.          unless the Remote option or the /REMOTE command-line  parameter
  5338.          is used.
  5339.  
  5340.          [port]        This parameter must  point to the COM-port  that
  5341.                        MTA will use. If set to 0, no remote tracking  is
  5342.                        done.
  5343.  
  5344.  Relate: BaudRate, Remote, FossilPort /REMOTE
  5345.  Dest. : All
  5346.  
  5347.  
  5348.  ┌─────────────────────────────────────────────────────────────────────┐
  5349.  │ FOSSILPort [port]                                                   │
  5350.  └─────────────────────────────────────────────────────────────────────┘
  5351.  Usage : This  option  can   be  used  as a replacement for  the COMPort
  5352.          option. The major difference is  that [port] will now point  to
  5353.          the FOSSIL port number (usually 1 less than the COM-port).
  5354.  
  5355.  Relate: BaudRate, Remote, COMPort /REMOTE
  5356.  Dest. : All
  5357.  
  5358.  
  5359.  ┌─────────────────────────────────────────────────────────────────────┐
  5360.  │ BAUDRate [baud]                                                     │
  5361.  └─────────────────────────────────────────────────────────────────────┘
  5362.  Usage : When  remote tracking is  used, MTA must  know the baudrate  of
  5363.          the MTA-to-Modem speed.
  5364.  
  5365.          [baud]        This parameter must be set to the connect  speed.
  5366.                        If you  use a  locked modem,  you must  set it to
  5367.                        the locked  speed and  not to  the connect speed.
  5368.                        If set to 0, remote tracking is disabled.
  5369.  
  5370.          Normally you use  the /BAUD command-line  parameter to set  the
  5371.          baud-rate because it can vary, unless a locked speed is used.
  5372.  
  5373.  Relate: COMPort or FOSSILPort, Remote, /REMOTE
  5374.  Dest. : All
  5375.  
  5376.  
  5377.  ┌─────────────────────────────────────────────────────────────────────┐
  5378.  │ StoreSize {ext}                                                     │
  5379.  └─────────────────────────────────────────────────────────────────────┘
  5380.  Usage : This option, on its   own, does nothing, but it will be  useful
  5381.          when  remote  tracking  is  active.  In  this case it will do a
  5382.          function  that  is  specific  to  FileDoor.  If  this option is
  5383.          active and  MTA is  running under  FileDoor, MTA  will create a
  5384.          special file  with a  specific format.  This file  contains the
  5385.          ACTUAL size of  the file BEFORE  the conversion. FileDoor  will
  5386.          detect this file and will credit the user for the actual  bytes
  5387.          that were uploaded and not  the newly created number of  bytes.
  5388.          For example the user uploads  A.ARC (10000 bytes) and MTA  will
  5389.          convert it to A.ZIP  (6000 bytes). Without StoreSize,  FileDoor
  5390.          will credit  the user  for 6000  bytes but  with StoreSize set,
  5391.          FileDoor will take the actual 10000 bytes as credit.
  5392.  
  5393.          {ext}  Normally, MTA will create a file with the name equal  to
  5394.                 the archive (without  extension) and the  extension XS1.
  5395.                 This extension can only be used in FileDoor  3.01+.  All
  5396.                 earlier versions (up to 3.01Γ5)  use  the  extension F$D.
  5397.                 When you run FileDoor 2.03 (up to 3.01Γ5) or a  clone of
  5398.                 FileDoor  that  uses this system, you  must change {ext}  to
  5399.                 the proper extension (F$D in case of FileDoor 2.03);
  5400.  
  5401.          Even if you don't run remote, you can still use this option. In
  5402.          this case, it is up to you (or a batch oriented program) to  do
  5403.          something with the created file(s).
  5404.  
  5405.  Relate: Remote
  5406.  Dest. : All
  5407.  
  5408.  
  5409.  ┌─────────────────────────────────────────────────────────────────────┐
  5410.  │ StoreName {nam}                                                     │
  5411.  └─────────────────────────────────────────────────────────────────────┘
  5412.  Usage : This option, on its   own, does nothing, but it will be  useful
  5413.          when  remote  tracking  is  active.  In  this case it will do a
  5414.          function  that  is  specific  to  FileDoor.  If  this option is
  5415.          active and  MTA is  running under  FileDoor, MTA  will create a
  5416.          special file  with a  specific format.  This file  contains the
  5417.          name of the archives before and after the  conversion. FileDoor
  5418.          will detect this file and will use it to see any altered  names
  5419.          AFTER the upload.
  5420.  
  5421.          {nam}  Normally, MTA will create a file with the name equal  to
  5422.                 FileDoor.XS2. This filename can only be used in FileDoor
  5423.                 versions 3.01 (3.01Γ6 up to release). Only  beta-testers
  5424.                 and users  of FileDoor <tm> clones will  have  to  alter
  5425.                 {name} to something different (FILEDOOR.F#D  for gamma's
  5426.                 up to 3.01Γ5.
  5427.  
  5428.          Even if you don't run remote, you can still use this option. In
  5429.          this case, it is up to you (or a batch oriented program) to  do
  5430.          something with the created file(s).
  5431.  
  5432.  Relate: Remote
  5433.  Dest. : All
  5434.  
  5435.  
  5436.  ┌─────────────────────────────────────────────────────────────────────┐
  5437.  │ StoreComment {ext}                                                  │
  5438.  └─────────────────────────────────────────────────────────────────────┘
  5439.  Usage : This option, on its   own, does nothing, but it will be  useful
  5440.          when  remote  tracking  is  active.  In  this case it will do a
  5441.          function  that  is  specific  to  FileDoor.  If  this option is
  5442.          active and  MTA is  running under  FileDoor, MTA  will create a
  5443.          special file  with a  specific format.  This file  contains the
  5444.          comment (from CarryComment or FileIDDIZ) for the specific  file
  5445.          that was uploaded by the user.
  5446.  
  5447.          {nam}  Normally, MTA will create a file with the name equal  to
  5448.                 FILEDOOR.XS3. This  name can  only be  used in  FileDoor
  5449.                 3.01+ (up from FileDoor 3.01Γ6). If you use  a  FileDoor
  5450.                 clone you will have to  alter {nam}  to  the  name  this
  5451.                 program uses;
  5452.  
  5453.          Even if you don't run remote, you can still use this option. In
  5454.          this case, it is up to you (or a batch oriented program) to  do
  5455.          something with the created file(s).
  5456.  
  5457.  Relate: Remote
  5458.  Dest. : All
  5459.  
  5460.  
  5461.  ┌─────────────────────────────────────────────────────────────────────┐
  5462.  │ Remote                                                              │
  5463.  └─────────────────────────────────────────────────────────────────────┘
  5464.  Usage : When set (and  when both COMPort and Baudrate  contain non-zero
  5465.          values), MTA will do remote tracking and will send messages  to
  5466.          the remote user.
  5467.  
  5468.  Relate: Baudrate,FOSSILPort,COMPort,StoreSize,StoreName,StoreComment
  5469.  Dest. : All
  5470.  
  5471.  
  5472.  ┌─────────────────────────────────────────────────────────────────────┐
  5473.  │ RemoteColor [txtlow] [txthig] [ok] [err] [act] [fil]                │
  5474.  └─────────────────────────────────────────────────────────────────────┘
  5475.  Usage : This  option can be  used to overrule  the default colors  that
  5476.          MTA uses for remote messages.
  5477.  
  5478.          [...]         There are 6 types of colors that can be   changed
  5479.                        to your own  needs. You must  supply ALL of  them
  5480.                        when  you  use  this  option.  [...] can have the
  5481.                        following values:
  5482.  
  5483.                        0  : Black            8  : DarkGray
  5484.                        1  : Blue             9  : LightBlue
  5485.                        2  : Green            10 : LightGreen
  5486.                        3  : Cyan             11 : LightCyan
  5487.                        4  : Red              12 : LightRed
  5488.                        5  : Magenta          13 : LightMagenta
  5489.                        6  : Brown            14 : Yellow
  5490.                        7  : LightGray        15 : White
  5491.  
  5492.                        You must supply  a value that  is made up  by the
  5493.                        foreground-color  and  background-color  with the
  5494.                        following formula:
  5495.  
  5496.                        Color = [Foreground] + 16 * [Background]
  5497.  
  5498.                        Only the values 0 to 7 can be used for the  back-
  5499.                        ground color. Also you  can add 128 to  the total
  5500.                        to force a blinking value !
  5501.  
  5502.                        [txtLow] This  is  the  low intensity text  color
  5503.                                 (common text). Default value is 3;
  5504.  
  5505.                        [txtHig] This  is the  high intensity  text color
  5506.                                 (common text). Default value is 11;
  5507.  
  5508.                        [Ok]     This is  the color to  display  ok-text.
  5509.                                 Default value is 10;
  5510.  
  5511.                        [Err]    This  is the  color to  display  errors.
  5512.                                 Default value is 12;
  5513.  
  5514.                        [Act]    This  is the  color to  display  special
  5515.                                 activity. Default value is 13;
  5516.  
  5517.                        [Fil]    This  is the  color to  display   files.
  5518.                                 Default value is 14;
  5519.  
  5520.          Local colors can  not be changed  (yet). Colors are  only shown
  5521.          when ANSI-support is used (so /ANS0 is not used).
  5522.  
  5523.  Relate: Remote
  5524.  Dest. : All
  5525.  
  5526.  
  5527.  3.3.9 Special statements
  5528.  ───────────────────────────────────────────────────────────────────────
  5529.  The following statements  are a collection  of statements that  can not
  5530.  be categorized in one of the other groups.
  5531.  
  5532.  ┌─────────────────────────────────────────────────────────────────────┐
  5533.  │ IncludeCtl [path]                                                   │
  5534.  └─────────────────────────────────────────────────────────────────────┘
  5535.  Usage : This parameter is optional. In MTA.CTL you can include one  (or
  5536.          several) other CTL-files. This comes in handy when you want  to
  5537.          separate  your  'normal'  run-time  options  and  the 'special'
  5538.          options you change much.
  5539.  
  5540.          MTA  can  handle  nested  IncludeCTL  statements.  So  you  can
  5541.          include 'IncludeCTL MTA.001' in your MTA.CTL and again you  can
  5542.          include  'IncludeCTL  MTA.002'  in  your  MTA.001.   The  total
  5543.          number of IncludeCTL options  (nested and in the  primary file)
  5544.          can be up to 16.
  5545.  
  5546.          [path]        This parameter must  point to the    control-file
  5547.                        you want to  include. The parameter  must contain
  5548.                        the drive, directory and filename.
  5549.  
  5550.  Relate: None
  5551.  Dest. : All
  5552.  
  5553.  
  5554.  3.3.10 Statements available when using a registered version
  5555.  ───────────────────────────────────────────────────────────────────────
  5556.  The following statements can  be used to define  one or more exits.  An
  5557.  exit a sort  of hook in  the MTA execution  process. The several  exits
  5558.  (hooks) are called at special places  while MTA is executing on one  or
  5559.  more files.  The user  can 'hook  into' the  process when  one or  more
  5560.  exits are defined in MTA.CTL.
  5561.  
  5562.  ┌─────────────────────────────────────────────────────────────────────┐
  5563.  │ RegistrationName [name]                                             │
  5564.  └─────────────────────────────────────────────────────────────────────┘
  5565.  Usage : This option  has only a meaning  when you received a  key after
  5566.          you registered MTA.  In ANY OTHER  case (non registered  usage)
  5567.          you must NOT include this option.
  5568.  
  5569.  Relate: None
  5570.  Dest. : All
  5571.  
  5572.  
  5573.  
  5574.  3.4 Diskette option
  5575.  ───────────────────────────────────────────────────────────────────────
  5576.  One of  the benefits  of MTA  is its  power to  convert diskettes  with
  5577.  great ease. This  method is only  functioning properly when  you have a
  5578.  PC with both floppy (FDU) and hard-disk (HDU).
  5579.  
  5580.  Most  users  with  hard-disks  will   have  a  collection  of   archive
  5581.  diskettes,  containing  their  (less)  used  software. When new archive
  5582.  systems are released  (or newer versions),  conversion of the  complete
  5583.  collection is sometimes needed (or wanted).
  5584.  
  5585.  You must activate MTA's diskette option with the /D switch. If you  do,
  5586.  MTA will start a conversion  cycle that can be interrupted  by pressing
  5587.  [ESC] when the next  diskette is finished. It  can be repeated for  the
  5588.  next diskette  when you  insert this  diskette into  the drive and when
  5589.  you press [ENTER].
  5590.  
  5591.  Which steps does MTA take to convert a diskette:
  5592.  
  5593.  - MTA  will read  all files  (the ones  matching the wildcard, normally
  5594.    you use the *.*  wildcard to select them  all) and will detect  which
  5595.    files are archives or not;
  5596.  
  5597.  - MTA will move (copy + delete) the archives to the directory that  you
  5598.    assigned  to  the  FDUTempPath  option.  If  you  also  supplied  the
  5599.    AllDisketteFiles option, MTA will also move all non-archive files  to
  5600.    that directory;
  5601.  
  5602.  - MTA  will convert  all archives  inside the  FDUTempPath directory to
  5603.    the new system or the higher release;
  5604.  
  5605.  - The exit ExitBeforeFill is called,  so you can do something with  the
  5606.    (empty if AllDisketteFiles was set) diskette (like a reformat);
  5607.  
  5608.  - Now  MTA will  sort the  converted (and  non-archive) files  based on
  5609.    size.  It  will  start  a  copy  for  each file, from the FDUTempPath
  5610.    directory (back) to  the diskette until  one of the  following events
  5611.    happens:
  5612.  
  5613.    - The diskette is full before the  last file is copied.  This can  be
  5614.      the  case  when  the  target  system  has  created  bigger files (a
  5615.      negative reduction); - The files are all moved;
  5616.  
  5617.    Depending on the type of event above, MTA will do the following:
  5618.  
  5619.    - When there are still files  left to copy back, MTA will  move these
  5620.      files to the directory you assigned in the FDUTrashPath option;
  5621.  
  5622.    - When all  files were moved  back to the  diskette and the  diskette
  5623.      still contains free space (you  had a positive reduction on  one or
  5624.      more archives), MTA  will look if  there is/are (a)  file(s) in the
  5625.      FDUTrashPath directory  that fit  on the  diskette. If  so, it will
  5626.      copy this(these) file(s) until the diskette is full or until  there
  5627.      are  no  files  left  that  will  fit  into  the  free space on the
  5628.      diskette;
  5629.  
  5630.  - MTA will now execute the ExitAfterFill EXIT if set;
  5631.  
  5632.  - MTA will ask for next diskette (or you press [ESC] to terminate);
  5633.  
  5634.  Please notice  that it  is possible  that MTA  leaves some files inside
  5635.  the FDUTrashPath  directory after  it has  finished. If  the number  of
  5636.  files  is  getting  to  big  (or  there  are  no more diskettes left to
  5637.  convert), insert an empty diskette in  the FDU and run MTA with  the /D
  5638.  option. Because  there are  no files  to convert,  MTA will  move files
  5639.  from the FDUTrashPath directory to this empty diskette. You can  repeat
  5640.  this  until  the  lower  threshold  is  reached  or until all files are
  5641.  moved.
  5642.  
  5643.  One final  word. As  you have  noticed (I  hope) you  can add unlimited
  5644.  power to  MTA's diskette  option with  the 'Before'  and 'After' exits.
  5645.  These  can  be  used  to  reformat  the diskette or something else (the
  5646.  'Before'  exit)  and/or  to  re-catalog  your  diskette  when you use a
  5647.  disk-catalog program (the 'After' exit).
  5648.  
  5649.  
  5650.  
  5651.  3.5 KeyBoard control
  5652.  ───────────────────────────────────────────────────────────────────────
  5653.  When MTA is executing you have control over some keyboard functions.
  5654.  
  5655.  When you  press [ESC]  (escape button),  MTA will  terminate AFTER  the
  5656.  current files is converted. When you  did hit [ESC] but you would  like
  5657.  to continue after all, you can do  so by hitting any other key.   Using
  5658.  the [ESC] key is not available  when you execute MTA with the  diskette
  5659.  option (/D).
  5660.  
  5661.  When you press [S], MTA will  start a DOS-shell, the moment it  is save
  5662.  to do so. This can be anywhere in the conversion phase. MTA will  place
  5663.  you in the  directory you started  MTA from. NEVER  alter files in  the
  5664.  temporary directory MTA  has created if  you do not  know what you  are
  5665.  doing. Also pressing  any other key  after [S], releases  the DOS-shell
  5666.  option as with [ESC].
  5667.  
  5668.  Pressing [T]  will cause  MTA to  toggle the  statistical display  from
  5669.  static  to  dynamic  mode  or  the  other  way around, depending on the
  5670.  default settings  (AltDisplay option).  You can  toggle as  much as you
  5671.  like while MTA is running. If you  run in a special text mode that  has
  5672.  more than  110 characters  for each  line, the  [T] button  is disabled
  5673.  because all possible screens are displayed.
  5674.  
  5675.  
  5676.  
  5677.  3.6 Running multiple copies of MTA at the same time
  5678.  ───────────────────────────────────────────────────────────────────────
  5679.  You ARE able to  execute multiple copies of  MTA at the same  time when
  5680.  you run a network or  a multitasking environment like DesqView  <tm> or
  5681.  MS-Windows <tm>.
  5682.  
  5683.  To  make  it  possible  for  MTA  to  execute concurrent, you take some
  5684.  special actions:
  5685.  
  5686.  - If you use the SubstDrive option, you must make sure you use as  many
  5687.    drive-letters in this option as you are going to run multiple  copies
  5688.    of MTA;
  5689.  
  5690.  - Make  sure  the  LASTDRIVE  option  is set along with the  SubstDrive
  5691.    option;
  5692.  
  5693.  - Make sure  you have SHARE.EXE  loaded in your  machine. Without SHARE
  5694.    MTA will make a mess of things (SURE !);
  5695.  
  5696.  - Make sure  that you run  all the concurrent  copies of MTA,  all with
  5697.    their  own  TASK-number.  You  assign  a  task  number with the /TASK
  5698.    command-line option. If  you forget this,  MTA will crash  because it
  5699.    will try to use the same substituted drive for each different task;
  5700.  
  5701.  After you have setup  MTA in the way  I described above, MTA  will give
  5702.  protection for some resources:
  5703.  
  5704.  - MTA will protect all the files it uses INTERNALLY;
  5705.  
  5706.  - All  log-files  (if  they  are  the  same in all copies of MTA),  all
  5707.    temporary  files,  all  directories  and  all  substituted drives are
  5708.    either unique to the task or SHARE'ed with all other tasks;
  5709.  
  5710.  - All  external files  (like the  FILES.BBS-alike files)  are protected
  5711.    when  they  are  altered.  This  means  that these files are SHARE'ed
  5712.    within the  multiple copies  of MTA  but also  with other  tasks that
  5713.    have SHAREing options like SOME Bulletin Board Systems;
  5714.  
  5715.  - When  two MTA's  want to  access the  same file  at the same time and
  5716.    with different attributes (one WRITE,  one READ for example), one  of
  5717.    the tasks will wait until the  file is released again. To over-  come
  5718.    problems with 'eternal  waits' (called deadlocks)  you can in-  stall
  5719.    an option in MTA.CTL that will manage the maximum time MTA will  wait
  5720.    before aborting. Waiting for allocation  of a file, will also  be the
  5721.    case  with  external  files,  provided  the  'other'  task  has  used
  5722.    SHAREing attributes with the open of that file. If you want to  abort
  5723.    the waiting (and MTA along the way), you can press [CTRL-E]. In  that
  5724.    case the 'deadlock' is released an MTA will abort;
  5725.  
  5726.  Some resources can NOT be protected by MTA:
  5727.  
  5728.  - MTA  will NOT  manage anything  that happens  within the  shell's. So
  5729.    when  the  (de)compressors  run  or  when  you  are within one of the
  5730.    supplied exits,  the called  program has  to manage  the SHAREing  by
  5731.    itself.
  5732.  
  5733.  It is almost stupid to say,  but be sure to convert different  files in
  5734.  each of the copies  of MTA. Letting two  or more copies of  MTA convert
  5735.  the same files, will cause  trouble. Though SHAREing is managed,  there
  5736.  could be  cases where  MTA is  waiting for  a file  (it will do so) and
  5737.  when this MTA gets the 'GO' signal, the file could be gone  (temporary)
  5738.  because one of the other copies of MTA is working on that file.
  5739.  
  5740.  Running  multiple  MTA's   in  a  multitasking   environment  works but
  5741.  there is a  big tradeoff. When  you don't have  enough 'power' on  your
  5742.  machine,  running  two  concurrent   copies  could  take   as  long  as
  5743.  serially running these copies.  (De)compressors  are  in the  habit  to
  5744.  eat lots  of your cycles. The multi-tasker also wants to have a  little
  5745.  snack and all   are eating   more  food   than  the   PC  can   supply,
  5746.  causing  delays,    low performance and   so on.  I  have  tested  with
  5747.  several machines, but you need  at  least a   true 386-25  (or a   very
  5748.  fast  286, like  a 20Mh)  or  higher to get  good results. But  in  the
  5749.  world  where these options  of MTA   are   needed,  machine-power    is
  5750.  usually  available. Also,  when you  run   MTA   concurrent  and    you
  5751.  use   only  the   /SIM   option, performance  is  not  so  very    much
  5752.  affected  because   MTA will only perform  a decompress (usually   this
  5753.  is very   fast).  This is the    case when you  run    MTA as  an  exit
  5754.  under some  BBS program (like FileDoor <tm>).
  5755.  
  5756.  
  5757.  3.7 Compression of single executable files (PKLITE)
  5758.  ───────────────────────────────────────────────────────────────────────
  5759.  With this version  of MTA, you  can also use  MTA to do  conversions of
  5760.  executable files to compressed  (self contained) executable files  with
  5761.  PKLITE. This feature merely comes as a bonus to the program.
  5762.  
  5763.  MTA's main  goal is  to convert  archives from  a certain  system to  a
  5764.  system you  like. The  compression of  EXE/COM files  can be  used as a
  5765.  separate function.
  5766.  
  5767.  Most of the  MTA.CTL statements have  no meaning to  this type of  con-
  5768.  version. You  can setup  MTA to  do nothing  BUT conversion  of COM/EXE
  5769.  files when  you set  the CompressionType  option to  PKLITE or UNPKLITE
  5770.  but in this case you only use around 10% of the programs functions.
  5771.  
  5772.  In most cases you setup  MTA to do a archive-to-archive  conversion and
  5773.  you set CompressionType to the system  you like. If you have setup  MTA
  5774.  like this (along with all possible  options), you can still use MTA  to
  5775.  convert  COM/EXE  files  by  including   /PKLITE  or  /UNPKLITE  as   a
  5776.  command-line parameter when you call  MTA. MTA will ignore all  options
  5777.  that have  nothing to  do with  the conversion  of executable files and
  5778.  will convert COM/EXE files from normal to PKLITE or back.
  5779.  
  5780.  I did not  include LZEXE because  the latest version  I have seen  can,
  5781.  only convert from normal to LZEXE'ed and not back.  There are  programs
  5782.  that can do the reversed (LZEXE'ed to normal) but there are at least  3
  5783.  I have seen and I can not create a protected and generalized  interface
  5784.  to all of them  (also because 2 of  them come as a  shell and not as  a
  5785.  stand-alone program). This does not  mean that MTA is not  LZEXE-aware.
  5786.  When  selecting  files,  MTA  takes  into  account if a COM/EXE file is
  5787.  already compressed with LZEXE (0.90 or 0.91) and will skip the file  in
  5788.  that case. When decompressing,  MTA will only select  PKLITE-compressed
  5789.  COM/EXE files.
  5790.  
  5791.  When  you  run  MTA  without  any  file-mask,  but  WITH the /PKLITE or
  5792.  /UNPKLITE  option  (or  CompressionType  set  to  one  of  both),   the
  5793.  tag-window will also change and  will only display available files  for
  5794.  this type compression.
  5795.  
  5796.  A file is available (and usable by MTA) for PKLITE if:
  5797.  
  5798.  - It is a COM or EXE file;
  5799.  
  5800.  - If it is not compressed with PKLITE, LZEXE 0.90 or LZEXE 0.91;
  5801.  
  5802.  - If  it is  not a  self-extracting archive  (SFX) of  any of the known
  5803.    archive systems;
  5804.  
  5805.  A file is available (and usable by MTA) for UNPKLITE if:
  5806.  
  5807.  - It is a COM or EXE file;
  5808.  
  5809.  - It is compressed with PKLITE;
  5810.  
  5811.  
  5812.  3.8 The MTA tag-window
  5813.  ───────────────────────────────────────────────────────────────────────
  5814.  When you  run MTA  without any  file-masks on  the command-line,  a tag
  5815.  menu is displayed. In this tag-menu  you have the option to tag  inside
  5816.  only ONE directory. A mix of files in several different directories  is
  5817.  impossible then you use the full-screen tag.
  5818.  
  5819.  When the  tag-menu is  displayed, you  CAN switch  to other directories
  5820.  and even to  other drives. If  one or more  of the displayed  drives is
  5821.  not  available  (not  ready,  door  open,  unformatted  disk) it can be
  5822.  selected but the  tag-window will ignore  it after it  has detected any
  5823.  error on that drive. In that case you must select another drive.
  5824.  
  5825.  When you  start MTA  with SFX  support (so  you include self extracting
  5826.  archives), all files  with abnormal extensions  and COM/EXE files  that
  5827.  are  SFX-files,  will  be  included.  The  testing  will  take a while,
  5828.  depending on the speed of the drive and the machine you have.
  5829.  
  5830.  If you start MTA with the PKLITE or UNPKLITE option, all available  AND
  5831.  usable files are  displayed (so only  decompressed executable files  or
  5832.  executable files, compressed with PKLITE).
  5833.  
  5834.  If you start MTA with the GIFLITE option, all available GIF files  that
  5835.  are not  already processed  by GIFLITE  (AND which  are valid  for MTA,
  5836.  based on the MaxGIFDim option) will be shown.
  5837.  
  5838.  If you start MTA with the GIF option, all available GIF files  that are
  5839.  present will be shown (normal AND GIFLITE).
  5840.  
  5841.  If  you  start  MTA  with  the  GIF2JPG option, all available GIF files
  5842.  (again with respect  to the MaxGifDim  option) are displayed.  When you
  5843.  used the JPG2GIF option, MTA will only show (all available) JPG files.
  5844.  
  5845.  
  5846.  
  5847.  3.9 MTA and unattended operations
  5848.  ───────────────────────────────────────────────────────────────────────
  5849.  There are a number of options that influence the way that MTA works  in
  5850.  unattended mode. Most of them you  can find out when the need  is there
  5851.  but some must be pointed out.
  5852.  
  5853.  In most cases  you will do  an unattended MTA  on the same  directories
  5854.  each time over and over. First I must point out the way you must  setup
  5855.  MTA to work in the right directories. This can be done in one of the  3
  5856.  following ways:
  5857.  
  5858.  - Put the  MTA in a  batch-file, change to  the right directory  before
  5859.    you call  MTA and  call MTA  with its  options (see  later). You  can
  5860.    repeat this for every directory. For example:
  5861.  
  5862.    ..
  5863.    ..
  5864.    D:
  5865.    CD \ZIP1
  5866.    MTA [parameters]
  5867.    E:
  5868.    CD \ZIP2
  5869.    MTA [parameters]
  5870.    ..
  5871.    ..
  5872.  
  5873.    To work on \ZIP1 on D: and \ZIP2 on E:;
  5874.  
  5875.  - Make the batch smaller and  use DefaultPath options in MTA.CTL.   You
  5876.    include DefaultPath  D:\ZIP1 and  DefaultPath E:\ZIP2  in MTA.CTL and
  5877.    you can reduce the previous batch to:
  5878.  
  5879.    ..
  5880.    ..
  5881.    MTA [parameters]
  5882.    ..
  5883.    ..
  5884.  
  5885.    To work on those two directories again;
  5886.  
  5887.  - You  would like  to run  MTA on  all your  directories of  a BBS. MTA
  5888. │  supports a number of BBS types. You include the  BBSPaths  option  in
  5889. │  MTA.CTL and inside the batch-file you perform:
  5890.  
  5891.    ..
  5892.    ..
  5893.    MTA [parameters]
  5894.    ..
  5895.    ..
  5896.  
  5897.    And MTA will work on all files in all BBS directories.
  5898.  
  5899.  Now the next problem. You must tel  MTA to work on some files. You  can
  5900.  do this in two different ways:
  5901.  
  5902.  - Use file-masks for [parameters].  In the previous examples you  could
  5903.    tell MTA to convert  all *.ZIP and *.LZH  files (ARJ is your  target)
  5904.    with  'MTA  *.ZIP  *.LZH'  and  MTA  will convert all *.ZIP and *.LZH
  5905.    files in the supplied directories;
  5906.  
  5907.  - Use  the MarkString  and NoMarked  options (or  /MAS and  /MAR on the
  5908.    command-line).  This is a better option. In the previous example  you
  5909.    would have  problems when  someone uploaded  a *.LZS  or *.ARC  file.
  5910.    These would  not be  converted. If  you used  *.* ALL  files would be
  5911.    converted   even    those   that    you   converted    earlier    !!!
  5912.    NoMarked can be used to tell  MTA only to convert files that  confirm
  5913.    to the supplied mask AND that  are not converted before. So with  the
  5914.    NoMarked and MarkString options set,  the call to MTA can  be changed
  5915.    to 'MTA  *.*'. Only  those files  that are  not converted  before are
  5916.    converted and will not be converted again until you set the  NoMarked
  5917.    option to OFF;
  5918.  
  5919.  - Use the OnlyNewFiles option (see the description of this option);
  5920.  
  5921.  Finally there are  some options that  you must change  or include. When
  5922.  you run MTA  in unattended mode  but you don't  want MTA to  run longer
  5923.  than a  certain amount  of time  (BBS events  !!) you  can include  the
  5924.  RunTime option to limit the number of minutes that MTA can run.
  5925.  
  5926.  Remember that MTA  will start in  a new archive  even when 1  second is
  5927.  left, so  you can  outrun the  RunTime by  the time  that your  machine
  5928.  needs to convert the last archive.
  5929.  
  5930.  Sometimes you can  get frequent warnings  on some files.  In unattended
  5931.  mode these  warnings won't  be seen,  neither do  you want  to hear the
  5932.  beeping, so put a value of  0 to the WarningTime option. All  important
  5933.  things are logged (when you put  on the logging). You can also  use the
  5934.  NoBeep option to  make the execution  of MTA more  quiet. When you  run
  5935.  MTA  as  an  exit  under  a  door  (FileDoor <tm>), you should keep the
  5936.  WarningTime option (set to 1 or  higher) and you should use the  NoBeep
  5937.  option. If you set  Warningtime to 0 in  this case, the user  won't see
  5938.  any error messages !
  5939.  
  5940.  REMEMBER. ALWAYS include  a file-mask. To  call MTA without  parameters
  5941.  in unattended mode will force MTA  to display the tag-menu and to  wait
  5942.  until you enter the files.
  5943.  
  5944.  
  5945.  
  5946.  3.10 TICK files and related material
  5947.  ───────────────────────────────────────────────────────────────────────
  5948.  As you know by now, there are several options that deal with TICK  (and
  5949.  its  clone  FES)  files.  I  won't  go  into the TICKFILES option. This
  5950.  option is described in detail in the CTL-section and is only  important
  5951.  with incoming files.
  5952.  
  5953.  It  becomes  different  with  TICK/FES  files  that  are  outbound ! In
  5954.  general you  have the  following problems  when you  run MTA over files
  5955.  that are also the subject of an outgoing TICK/FES file:
  5956.  
  5957.  - The messages that are generated by TICK and FES, contain the name  of
  5958.    the archive. With a conversion from  ARC to ZIP, this will cause  the
  5959.    file to be renamed from A.ARC  to A.ZIP but the messages generated by
  5960.    TICK/FES still contain A.ARC !
  5961.  
  5962.  - The TICK/FES files  ALSO contain the name  A.ARC, so that is  another
  5963.    problem;
  5964.  
  5965.  - The TICK/FES files also contain  the CRC of the A.ARC file.  Obvious,
  5966.    when you convert  A.ARC to A.ZIP,  the CRC will  also be changed  but
  5967.    the TICK/FES files still contain the old CRC;
  5968.  
  5969.  MTA  can  deal  with  all  these  problems.  You  must  use a number of
  5970.  special options to  do so  (using  them  will cause  some overhead   on
  5971.  MTA)  but after implementing them,  you won't  have any trouble  with a
  5972.  conversion of  a file  that   is also  subject of   a TICK/FES file. In
  5973.  general, these options can also deal with other products than  TICK/FES
  5974.  if they  work in the same way.
  5975.  
  5976.  The following options must be set and will do the following:
  5977.  
  5978.  - UpdateTICKFiles and/or UpdateFESFiles
  5979.    You can add up  to 10 of EACH  options all pointing to  file-masks in
  5980.    certain directories. When you have set  up the BBS is a way  that you
  5981.    support different  TICK/FES outbound  directories for  different nets
  5982.    (or zones), you must point to all of them, for example:
  5983.  
  5984.    UpDateTickFiles D:\MAILER\OUTBOUND\TICZONE1\*.TIC
  5985.    UpDateFESFiles  D:\MAILER\OUTBOUND\TICZONE1\*.FES
  5986.    UpDateTickFiles D:\MAILER\OUTBOUND\TICZONE2\*.TIC
  5987.    UpDateTickFiles D:\MAILER\OUTBOUND\TICZONE5\*.TIC
  5988.  
  5989.    When A.ARC is  converted  to  A.ZIP, MTA will   scan ALL these  files
  5990.    in the  supplied directories  and search   for hits  for A.ARC.  When
  5991.    found, A.ARC  is changed  in A.ZIP.   The TICK/FES  files are changed
  5992.    as binary  files. MTA  reads up  to 16K  of data  per file and does a
  5993.    search  on   the  changed  item.  As  a   result  of this, it  is NOT
  5994.    possible  to   use  these  options  when  the   file-name  length  is
  5995.    changed. So  a   conversion from  A.MD to  A.ARC and  reversed is NOT
  5996.    supported. The changed  files  don't  have  to   be  TICK/FES   files
  5997.    but  these  files contain the filename (obvious).  If  your   product
  5998.    also  creates  a  file  with a filename inside, MTA can still  do the
  5999.    job !
  6000.  
  6001.  Now  you  have  a choice either to use the UpdateUntypedFiles option OR
  6002.  the UpdateMSGFiles option. The choice depends on the number of messages
  6003.  that are  normally  inside the MSG-directory. If this are many messages
  6004.  (100 or more), you  should  use  the UpdateMSGFiles option. If it are a
  6005.  small number of messages, you should use the UpdateUntypedFiles option.
  6006.  The UpdateUntypedFiles  option  will update very fast but will slowdown
  6007.  MTA when there are many files (*.MSG files in this case) to search thru
  6008.  after each conversion. The  UpdateMSGFiles  is somewhat slower than the
  6009.  UpdateUntypedFiles  option  but will benefit from the fact that it only
  6010.  has to search ALL  messages  ONCE and will then update ONLY THE RELATED
  6011.  files. I will describe both:
  6012.  
  6013.  - UpdateUntypedFiles
  6014.    You can add up to 10 of these options. In our TICK/FES example,  this
  6015.    option must point to the  netmail directory (outbound) be- cause  the
  6016.    *.MSG files must also be changed. For example:
  6017.  
  6018.    UpDateUntypedFiles D:\MAILER\OUTBOUND\TICZONE1\*.MSG
  6019.    UpDateUntypedFiles D:\MAILER\OUTBOUND\TICZONE2\*.MSG
  6020.    UpDateUntypedFiles D:\MAILER\OUTBOUND\TICZONE5\*.MSG
  6021.  
  6022.    MTA will do the same with these files (obvious they are the  outbound
  6023.    messages). This option differs from  the previous 2 in the  fact that
  6024.    UpdateTICKFiles and UpdateFESFiles ALSO  change the CRC (32-bit  CRC)
  6025.    of the files and this option ONLY the file names;
  6026.  
  6027.  - UpdateMSGFiles
  6028.    You can add up to 255 of these options. In our TICK/FES example, this
  6029.    option must point to the netmail directory (outbound) where the *.MSG
  6030.    files will be. For example:
  6031.  
  6032.    UpDateMSGFiles D:\MAILER\OUTBOUND\TICZONE1\
  6033.    UpDateMSGFiles D:\MAILER\OUTBOUND\TICZONE2\
  6034.    UpDateMSGFiles D:\MAILER\OUTBOUND\TICZONE5\
  6035.  
  6036.    The result  of  these  options  will  be  the same as in the previous
  6037.    example  for  the  UpdateUntypedFiles  option  BUT  will  work  in  a
  6038.    different  way.  Where  UpdateUntypedFiles  will scan ALL *.MSG files
  6039.    after EVERY  converted  files  (this  can  slow down the process when
  6040.    there are MANY messages to  search thru), UpdateMSGFiles will work in
  6041.    he following way:
  6042.  
  6043.    - When MTA starts, MTA will  look  in ALL CONFIGURES message areas (3
  6044.      in the case of our previous example, can be up to 255);
  6045.  
  6046.    - For  every  area  whete there is at least ONE message found with an
  6047.      attached  file, MTA will create a record in a special file which is
  6048.      called  MTA$$$$$.MFA  (in  the  current  directory or the directory
  6049.      pointed to by the MTATEMPPATH option);
  6050.  
  6051.    - Each  record can contain information for message numbers 1 to 65000
  6052.      which would be enough;
  6053.  
  6054.    - Now AFTER  the  conversion  of EVERY file, MTA will search thru the
  6055.      MTA$$$$$.MFA file and  will  only  try  to change the messages that
  6056.      have attached  files  in  the message. The change will only be done
  6057.      when the filename of the  old file (f.i. A.ARC) will match the name
  6058.      in the message;
  6059.  
  6060.    - Before  termination, MTA  will  delete the MTA$$$$$.MFA file again;
  6061.  
  6062.    With this  flow  of  action, MTA will only have to check the messages
  6063.    that have files attached to them, which will normally be only a small
  6064.    percentage of the total number of messages.
  6065.  
  6066.  
  6067.  When you use the UpdateTICKFiles/UpdateFESFiles options in combination
  6068.  with the UpdateUntypedFiles/UpdateMSGFiles options to update your TICK
  6069.  or FES files (incomming and outgoing), you  should also set one of the
  6070.  two related options UpdateUntypedFULL or UpdateMSGFull.
  6071.  
  6072.  DON'T   use   this   options   when   you   don't  work with a TICK/FES
  6073.  alike  complex.    When   UpdateTICKFiles      and/or    UpdateFESFiles
  6074.  options    are present  in   MTA.CTL, MTA   will ALWAYS   calculate the
  6075.  32-bit CRC of the  source  and   the  target.   This  causes   overhead
  6076.  when there are never updates for  TICK or  FES files.  The 32-bit   CRC
  6077.  is  fast but on a big number of  files  it will still  count ! If   you
  6078.  have TICK  or FES files that  are BIGGER than 16K, please  contact  me.
  6079.  I can change MTA   to make it compatible with  files up to 64K, but  it
  6080.  will cause memory  overhead.   Only when  your seen-by   lines are   to
  6081.  many  to mention, these problems will occur !
  6082.  
  6083.  
  6084.  
  6085.  3.11 FES, yet another TICK-clone ?
  6086.  ───────────────────────────────────────────────────────────────────────
  6087.  By now you will  have seen the   word FES  several  times. In zone   2,
  6088.  net 24x, most  of the  people know  FES. FES  looks like  a  TICK-clone
  6089.  but  implements  some  nice  features   (including  its  own  type   of
  6090.  communication files,  called  *.FES)  that  are  not  found  in   TICK.
  6091.  FES  is   already  released    but   development    goes    on.    Most
  6092.  eye-catching   is the  HATCH procedure  that gives  you a user-friendly
  6093.  interface between your   files, FILES.BBS (in  AND out) and   yourself.
  6094.  FES can optionally create  FES or TICK files for a given node.
  6095.  
  6096.  If TICK is  all you want,  stay with   TICK or take  a peek at  FES. If
  6097.  you are doing distribution yourself  (so adding new files to  a chain),
  6098.  like I do,  FES could  be it.   Also, if  you have  nodes that  want  a
  6099.  large number  of files   from certain  area's,   FES can  also  come in
  6100.  handy  and there is even a FESFix option to obtain files from remote.
  6101.  
  6102.  FES can be  obtained from several  german BBS's and  the author can  be
  6103.  contacted thru FidoNet.
  6104.  
  6105.  
  6106.  
  6107.  3.12 Special ARC considerations
  6108.  ───────────────────────────────────────────────────────────────────────
  6109.  There  are   a  few   special  ARC-files.   These  are   the files that
  6110.  are normally created with a clone of ARC or with ARC 7.xx (or  whatever
  6111.  SEA likes  to  call  it).  In  MOST  cases,  these  archives  can   not
  6112.  be decompressed   with  ARC,   PAK  or   PKUNPAK  but   need a  special
  6113.  kind of program.
  6114.  
  6115.  So far  I   have NO  information   about SEA's  new   archiver and that
  6116.  will stay  that  way   unless  either  SEA   or  someone else can  give
  6117.  me full details  about  the   operation  of  this  program. Until  that
  6118.  time, SEA  eXtended   (7.xx)   archives   will   NOT   be  supported as
  6119.  OUTPUT (target) files.
  6120.  
  6121.  There  ARE  is  a   special  program  that  is   able  to EXTRACT these
  6122.  special type of   archives. It   is called   XARC.EXE and   is released
  6123.  by SEA  for PD/Shareware  (??) usage.  XARC   must be  executed without
  6124.  any parameters and  is therefore not  suitable to be  included in MTA's
  6125.  ARCPath option !
  6126.  
  6127.  The same  story goes  for some   very old  types of  archives that  are
  6128.  more or  less compatible  to the  older   ARC. An  example is the older
  6129.  ARCA and its counterpart  ARCE but  these files  will, in  general,  be
  6130.  available for decompress with ARC, PAK or PKUNPAK.
  6131.  
  6132.  From  my  point  of  view,  it  is  very difficult to support all these
  6133.  non-standard formats.   But to make  it more flexible,  I have included
  6134.  ONE options  that makes  it possible  to use  a special  un-arc program
  6135.  that will be used  for all ARC-alike archives.   You could even call  a
  6136.  special  shell  program  that  can  see  the  difference  between   all
  6137.  ARC-formats  (I  do  NOT  mean  the  difference  between  ARC,  PAK and
  6138.  PKUNPAK, MTA  can see  this for  itself) and  calls the  correct un-ARC
  6139.  procedure for  the supplied  archives.   This option  is the  UNARCPath
  6140.  option.   The program  that is  supplied in  this option  will ONLY  be
  6141.  called   for    DECOMPRESSION   and    is   called    as    PROGRAM.EXT
  6142.  DRIVE:\PATH\ARCHIVEN.AME  (no  options,  only   the  archive  and   its
  6143.  location is presented in the call).
  6144.  
  6145.  The  UNARCPATH  option  is  designed  to  be used with XARC.EXE or with
  6146.  ARCE.EXE/ARCE.COM when you don't expect eXtended SEA archives !
  6147.  
  6148.  If you include the following:
  6149.  
  6150.  ARCPATH   C:\ARC\ARC.EXE  [rest of MTA-parameters]
  6151.  UNARCPATH C:\ARC\XARC.EXE [rest of MTA-parameters]
  6152.  
  6153.  The following will happen  when MTA is called  to convert A.ARC to  the
  6154.  ARC format:
  6155.  
  6156.  - XARC.EXE (or its substitute) is called for decompress;
  6157.  - ARC.EXE  (or its substitute) is called for compress;
  6158.  
  6159.  The following will happen  when MTA is called  to convert A.ARC to  the
  6160.  ZIP (or any NON-ARC) format:
  6161.  
  6162.  - XARC.EXE  (or its substitute) is called for decompress;
  6163.  - PKZIP.EXE (or its substitute) is called for compress;
  6164.  
  6165.  Now the same  sequences without UNARCPath  set and without  XARC.EXE in
  6166.  your DOS-path:
  6167.  
  6168.  - ARC.EXE  (or its substitute) is called for decompress;
  6169.  - ARC.EXE  (or its substitute) is called for compress;
  6170.  
  6171.  and
  6172.  
  6173.  - ARC.EXE   (or its substitute) is called for decompress;
  6174.  - PKZIP.EXE (or its substitute) is called for compress;
  6175.  
  6176.  The latter can  result in errors  when A.ARC is  a SEA eXtended  (7.xx)
  6177.  archive. The first examples will run fine !
  6178.  
  6179.  If you think this is all, then read on. It will become rather messy.
  6180.  In their development, NoGate (PAK) and SEA (ARC) have both found it
  6181.  the correct procedure to keep the internal archive format the same
  6182.  (understandable, you will be backward compatible), but they both use
  6183.  the archive version-number 10 (and maybe higher on SEA's format, but
  6184.  information is not available to me) for their extended format. In the
  6185.  NoGate version, 10 is crushed, in the SEA format, 10 is something else
  6186.  (eXtended in any case because XARC can decompress it). Now see what
  6187.  happens with A.ARC (an eXtended archive, containing 10 files, created
  6188.  with ARC 7.xx):
  6189.  
  6190.  - A.ARC contains 10 files all with code 10;
  6191.  
  6192.  - Code 10 is PAK crushed;
  6193.  
  6194.  - PAK.EXE with extract is called to decompress the archive;
  6195.  
  6196.  - The  result is  an archive  in error  and not  converted because  PAK
  6197.    terminates with error 'CRC error in data' or something else;
  6198.  
  6199.  Nothing can keep me from thinking that the same COULD also be the  case
  6200.  for code 11 (NoGate destilled, SEA  whatever) or even higher !   In any
  6201.  case it is a complete mess and  about 10K of coding in MTA is  consumed
  6202.  by these  little jokes.  The actual  victims are  the users who receive
  6203.  ARC 7.xx files AND PAK files.  Our dear friends in the SDN/SDS  circuit
  6204.  to name but a few !
  6205.  
  6206.  MTA fixes the problem with the ARC-version 10 and 11 with a rather  Q&D
  6207.  solution.  When  PAKPath  AND  UNARCPath  are available in MTA.CTL, MTA
  6208.  will  first  call  PAK  with  the  T  (test)  option.  If the resulting
  6209.  errorlevel is  not 0,  MTA will  use the  program you  supplied in  the
  6210.  UNARCPath option  (e.g. XARC.EXE).  If the  resulting errorlevel equals
  6211.  0, MTA will use  the program you supplied  in the PAKPath option  (e.g.
  6212.  PAK.EXE).
  6213.  
  6214.  When the PAKPAth option is NOT available and PAK.EXE is not in the  DOS
  6215.  path but A.ARC  contains files with  archive-code 10, MTA  will use the
  6216.  program supplied in UNARCPATH by default, EVEN when A.ARC was a  NoGate
  6217.  archive with crushed  files (in which  case the decompress  will result
  6218.  in an error).  When the PAKPath  option IS available  but the UNARCPath
  6219.  option is NOT, A.ARC will be  marked as a NoGate archive (even  when it
  6220.  is SEA  eXtended) and  the program  supplied in  the PAKPath  option is
  6221.  used (resulting in an  error when A.ARC was  SEA eXtended).  When  BOTH
  6222.  are NOT supplied,  MTA will give  an error because  neither PAKPath nor
  6223.  UNARCPath are present.
  6224.  
  6225.  The special  dirty tricks  that must  be executed  on these  files will
  6226.  result  in  somewhat  overhead  but  should  work full-proof. Because I
  6227.  dislike 2 versions per  day, I do the  same with archives that  contain
  6228.  only ARC-version 11 files). Normal  users should not use the  UNARCPath
  6229.  option  UNLESS  they  got  trouble.  SDS/SDN  sysops will have no other
  6230.  choice than to include them (in general).
  6231.  
  6232.  You can make up your own mind about all these special tricks that  must
  6233.  be executed to serialize an archive  in the correct way. I myself  find
  6234.  it rather strange that these mixups are created in the first place.
  6235.  
  6236.  
  6237.  3.13 Using newer versions of archivers
  6238.  ───────────────────────────────────────────────────────────────────────
  6239.  Once in a while you receive new versions of the archivers that you  use
  6240.  (or don't use). In  some cases, it is  quit a risk to  start converting
  6241.  all  files  to  the  new  version  (certainly  when  you  receive  beta
  6242.  versions) and in some other cases  you would like to see if  a specific
  6243.  new option is indeed working and giving you the expected result.
  6244.  
  6245.  UNLESS the  internal format  of the  archive is  changed, MTA  can work
  6246.  with a ALTernate set of  archive-program versions. This comes in  handy
  6247.  when you want to test the new version on various files but in the  mean
  6248.  while  you  would  like  to  convert  all  other  files  with the older
  6249.  version.
  6250.  
  6251.  All you have to do is the following:
  6252.  
  6253.  - Rename the new version (for example, you receive PKZIP/PKUNZIP  2.0ß,
  6254.    in  which  case   you  could  rename   PKZIP.EXE  to  P2ZIP.EXE   and
  6255.    PKUNZIP.EXE to P2UNZIP.EXE);
  6256.  
  6257.  - Alter the xxxPath option(s) in MTA.CTL. You must add the path to  the
  6258.    new version as the LAST parameter in the option. In this example  you
  6259.    add the path, C:\ARC\P2ZIP.EXE to  the PKZIPPath option and also  you
  6260.    add  C:\ARC\P2UNZIP.EXE  to  the  PKUNZIPPath  option. They will look
  6261.    something like:
  6262.  
  6263.    PKZIPPath   C:\ARC.PKZIP.EXE   N 200 C:\ARC\P2ZIP.EXE
  6264.    PKUNZIPPath C:\ARC.PKUNZIP.EXE N 200 C:\ARC\P2UNZIP.EXE
  6265.  
  6266.    You can do this for each and every archiver (GIF-conversion  program)
  6267.    you use;
  6268.  
  6269.  - Alter the xxxVersion option in  MTA.CTL. You must add the version  of
  6270.    the new release as the second parameter to the xxxVersion  option(s).
  6271.    In the example, you  normally use PKZIP 1.10  and will start to  test
  6272.    the PKZIP 2.01. In  this case you change  ZIPVersion so it will  have
  6273.    both values showed (ZIPVersion 110 201);
  6274.  
  6275.  When you are finished with the  changes, you can execute MTA as  normal
  6276.  to get  the 'normal'  versions of  all archivers.  When you execute MTA
  6277.  with  the  (optional)  /ALT  command-line  parameter,  MTA will look if
  6278.  there is  a second  path available  inside the  xxxPath option and will
  6279.  use THAT one.  If it is  not set, MTA  will use the  original path from
  6280.  this option (e.g. there is no new version present). After this  routine
  6281.  is  finished,  MTA  will  look  if  there  is a second value set in the
  6282.  xxxVersion. If so, MTA will use that one, otherwise the original  value
  6283.  (or the default value) is used. With our example and in short:
  6284.  
  6285.  MTA *.*         will convert files, using  PKZIP/PKUNZIP (1.10)    when
  6286.                  needed, to the format you have set;
  6287.  
  6288.  MTA *.* /ALT    will  convert files, using  P2ZIP/P2UNZIP (2.01)   when
  6289.                  needed, to the format you have set;
  6290.  
  6291.  
  6292.  3.14 Lo-tek functions, calling MTA as shell under MTA
  6293.  ───────────────────────────────────────────────────────────────────────
  6294.  MTA can only call itself as  a  child (to work on arc-in-arc files). If
  6295.  you try to run MTA as a shell  of  MTA (e.g. you press [S] to shell out
  6296.  if MTA and start MTA again),  you will get a message and the second MTA
  6297.  will abort.
  6298.  
  6299.  This coding is present for a  various  number of reasons (one of the is
  6300.  the usage of SUBST functions). If  for  some reason these functions can
  6301.  not be used, MTA will give a 'lo-tek' warning  and will perform various
  6302.  other tests  to  make  sure  that  it's  own working-environment is not
  6303.  trashed by other tasks.
  6304.  
  6305.  
  6306.  3.15 TEC files
  6307.  ───────────────────────────────────────────────────────────────────────
  6308.  With every release, one or more *.TEC files will be supplied. These TEC
  6309.  files will each go deeper into some delicate subjects. The TEC files
  6310.  are based upon the most frequently asked questions. These problems can
  6311.  range from examples for simple setups to discussions about comments in
  6312.  archives.
  6313.  
  6314.  ┌───────┬─────────────────────────────────────────────────────────────┐
  6315.  │   4   │ Runtime information                                         │
  6316.  └───────┴─────────────────────────────────────────────────────────────┘
  6317.  
  6318.  4.1 Command-line parameters
  6319.  ───────────────────────────────────────────────────────────────────────
  6320.  Most of  the information  that MTA  needs is  obtained from the MTA.CTL
  6321.  configuration  file.  When  you  want  to  change  one (or some) of the
  6322.  options temporary, you can use command-line parameters to do so.
  6323.  
  6324.  The syntax to start execution of MTA is:
  6325.  
  6326.  MTA {filespec} {filespec}..{filespec} {CMD} {CMD}..{CMD}
  6327.  
  6328.  {filespec} is  the  optional  wildcard  (or complete filename) you  can
  6329.             supply. You can supply up  to 25 {filespec} values. You  can
  6330.             use the normal DOS  wildcards AND the special  wildcard that
  6331.             is supplied in  almost ALL DISP-programs.  This is the  '='.
  6332.             This wildcard  can be  used for  a shifted  test. =MTA  will
  6333.             select  files   with  the   names  doMTA.bat,   MTAtest.zip,
  6334.             newMTA.me. If you want to  include the '.', you MUST  supply
  6335.             it in the wildcard. =A.Z will include mtaA.Zip and so on.
  6336.  
  6337.             If you do  not supply a  {filespec} a full-screen  menu will
  6338.             be  shown.  This  menu  can  be  used to select files in ONE
  6339.             directory.
  6340.  
  6341.  {CMD}      You  can  (optionally)   supply  one  or more   command-line
  6342.             options  when  you  execute  MTA.  Some  of  the work like a
  6343.             toggle, some  of the  overrule options  in MTA.CTL,  some of
  6344.             them can only switch on or off in MTA.CTL.
  6345.  
  6346.             In general, the /STOSIZ, /STOCOM and /STONAM toggles work in
  6347.             the old-fashioned way, command-line options that work like a
  6348.             toggle, can be supplied in two different ways:
  6349.  
  6350.             - /CMDOPT
  6351.               With this format  you  reverse  (toggle) the option in the
  6352.               MTA.CTL file  but  you need to know for sure in what state
  6353.               the option  in  MTA.CTL  is. In  other  words, if  the FOO
  6354.               option  is set in  MTA.CTL, /FOO will switch is off. If it
  6355.               was off in MTA.CTL, /FOO will switch it to on;
  6356.  
  6357.             - /CMDOPT+ or /CMDOPT-
  6358.               With  this  format  you can explicitly switch an option on
  6359.               (with /COMOPT+)  or off (with /CMDOPT-). You don't need to
  6360.               know in what state the option in MTA.CTL is;
  6361.  
  6362.             The three switches mentioned earlier (/STONAM, /STOSIZ and
  6363.             /STOCOM) work in the old way (+ or - is NOT possible). This
  6364.             is the result of the extended format (where a name can be
  6365.             supplied along with the command-line option).
  6366.  
  6367.             A  command-line  parameter  must  start  with a slash ('/').
  6368.             Multiple command-line parameters  must be separated  with at
  6369.             least one  space. If  the command-line  parameter has  extra
  6370.             values, the  must follow  the parameter  itself WITHOUT  any
  6371.             spaces between the command-line parameter and the value.  If
  6372.             the value must  include spaces, you  must replace them  with
  6373.             the underscore character. So if you use the /M  command-line
  6374.             option to move files to C:\ZIP, you must supply /MC:\ZIP;
  6375.  
  6376.  The following command-line options are available and can be used:
  6377.  
  6378.  4.1.1 Command-line parameters that stand on their own
  6379.  ───────────────────────────────────────────────────────────────────────
  6380.  The following command-line  parameters can be  used (in special  cases)
  6381.  and they don't have any counterpart in MTA.CTL.
  6382.  
  6383.  
  6384.  ┌─────────────────────────────────────────────────────────────────────┐
  6385.  │ /?                                                                  │
  6386.  └─────────────────────────────────────────────────────────────────────┘
  6387.  Function : Using /? will  activate MTA's help system. When  this system
  6388.             is invoked, no conversion will be possible. You are shown  a
  6389.             screen where  all command-line  options are  described.  You
  6390.             can now hit the [ENTER] key and you will have the option  to
  6391.             setup the  calling sequence  for MTA.  You can  do this  for
  6392.             different options until  you have all  the options you  need
  6393.             (so you can read about  the option and its syntax  while you
  6394.             can write  it down  in the  help-screen's little note-book).
  6395.             When you have finished (use  [ESC]), the system will make  a
  6396.             batch-file, called GOMTA.BAT  with all this  options inside.
  6397.             You can  start this  batch-file (and  you can  even add some
  6398.             extra parameters to it);
  6399.  
  6400.  ┌─────────────────────────────────────────────────────────────────────┐
  6401.  │ /CTL[path]                                                          │
  6402.  │ /CTL[file]                                                          │
  6403.  └─────────────────────────────────────────────────────────────────────┘
  6404.  Function : By default,  MTA will use MTA.CTL  IF the file is  somewhere
  6405.             in  the  DOS  path  (DOS  2.x  and  higher),  in the current
  6406.             directory (all DOS versions)  or in the directory  where the
  6407.             MTA.EXE file resides (DOS  3.x and higher). If  your MTA.CTL
  6408.             does not  follow this  conventions OR  you want  to assign a
  6409.             different name for it OR  you want to use an  alternate file
  6410.             for special tasks, you can instruct MTA to use this file  if
  6411.             you supply the /CTL command-line parameter. It comes in  two
  6412.             forms. Either  you supply  a complete  path (eg.  the drive,
  6413.             directory and filename, or you just supply the filename,  if
  6414.             MTA is able to  find it in the  same was as it  can find the
  6415.             MTA.CTL (path, current directory, executed directory).
  6416.  
  6417.  ┌─────────────────────────────────────────────────────────────────────┐
  6418.  │ /TASKnn                                                             │
  6419.  └─────────────────────────────────────────────────────────────────────┘
  6420.  Function : If you  want to run multiple  (concurrent) runs of MTA,  you
  6421.             must  supply  a  task-number  to  each  of  the concurrently
  6422.             running  tasks.  By  default,  MTA  assumes that is will run
  6423.             stand alone. If  this is not  the case, you  must supply the
  6424.             /TASK switch  with a  task-number from  01 to  99. Each con-
  6425.             currently running MTA must have a different task-number !
  6426.  
  6427.  ┌─────────────────────────────────────────────────────────────────────┐
  6428.  │ /LVL0                                                               │
  6429.  │ /LVL1                                                               │
  6430.  │ /LVL2                                                               │
  6431.  │ /LVL3                                                               │
  6432.  └─────────────────────────────────────────────────────────────────────┘
  6433.  Function : There are several  command-line parameters that can be  used
  6434.             to  limit  (extend)  the  search  for files to be converted.
  6435.             The set  of /LVLx  command-line parameters  can be  used (in
  6436.             combination with  the filemask(s))  to define  WHERE MTA has
  6437.             to look for files. They  can be used as command-line  driven
  6438.             replacement for some of the options in MTA.CTL  (DefaultPath
  6439.             to name one). The search is extended in the following way:
  6440.  
  6441.             /LVL0 : The  search will be  done in the  CURRENT directory.
  6442.                     This is the  same as NOT  using any DefaultPath  (or
  6443.                     alike) option in  MTA.CTL or using  /W when you  did
  6444.                     set these options.  It can be  overruled to run  MTA
  6445.                     from  the   command-line  for   just  the    current
  6446.                     directory without having  to change the  DefaultPath
  6447.                     (or alike) options in MTA.CTL;
  6448.  
  6449.             /LVL1 : With /LVL1,  MTA will  look in  all  sub-directories
  6450.                     under (NOT INCLUDING) the current directory;
  6451.  
  6452.             /LVL2 : With /LVL2,  MTA will  look in  all  sub-directories
  6453.                     under AND the current directory;
  6454.  
  6455.             /LVL3 : With /LVL3, MTA will search the whole CURRENT  drive
  6456.                     (all directories included);
  6457.  
  6458.  ┌─────────────────────────────────────────────────────────────────────┐
  6459.  │ /@[path]                                                            │
  6460.  └─────────────────────────────────────────────────────────────────────┘
  6461.  Function : All  the  files  you  want  to  convert  can  be selected in
  6462.             several ways.  The usage  of the  /@ command-line  option is
  6463.             just  only  one  of  them.  [path]  must  point  to a drive,
  6464.             directory  and  filename  that  exists.  This file must be a
  6465.             ASCII flat-file  (created with  any normal  line-editor) and
  6466.             it must contain  one filename on  each line (any  drives and
  6467.             directories are stripped by MTA internally). All files  must
  6468.             reside  in  one  directory.  It  is allowed to use wildcards
  6469.             but, unlike the  masks you can  supply on the  command-line,
  6470.             the extension '.*' is NOT  added when you do not  supply any
  6471.             extension.   MTA  will  convert  all  these  files  (if they
  6472.             exist) after each  other. You can  use /@ when  the masks on
  6473.             the normal command-line would  exceed the maximum number  of
  6474.             bytes of a parameter list.
  6475.  
  6476.             As an extension  to  this  option, it is now also allowed to
  6477.             supply  various  files   with   directory-names  in  VARIOUS
  6478.             directories  (usage  for some popular programs that call MTA
  6479.             to convert archives). There  is  one  flaw. If  you use this
  6480.             format, MTA will search for all supplied files in ALL of the
  6481.             supplied directory, so:
  6482.  
  6483.             F:\ZIP\TEST.ZIP
  6484.             C:\TEST\WANTED.ARJ
  6485.  
  6486.             Will force MTA to convert TEST.ZIP and WANTED.ARJ in F:\ZIP
  6487.             and to convert TEST.ZIP and WANTED.ARJ in C:\TEST. Normally
  6488.             this is no problem  because only one of the two will reside
  6489.             in each directory.
  6490.  
  6491.  ┌─────────────────────────────────────────────────────────────────────┐
  6492.  │ /IP[password]                                                       │
  6493.  └─────────────────────────────────────────────────────────────────────┘
  6494.  Function : With  MTA you can  convert encrypted files.  When you select
  6495.             such files, you MUST  supply the original password  that was
  6496.             used for encryption.  You can only  supply ONE password  for
  6497.             each  execution  of  MTA,  so  when you must convert various
  6498.             files with  various passwords,  you must  do so  in separate
  6499.             runs of MTA. The password that is needed for the  decompress
  6500.             of the input-file,  is supplied with  the /IP option.  There
  6501.             is (obvious) no counterpart in MTA.CTL;
  6502.  
  6503.  ┌─────────────────────────────────────────────────────────────────────┐
  6504.  │ /OP[password]                                                       │
  6505.  │ /OP@                                                                │
  6506.  └─────────────────────────────────────────────────────────────────────┘
  6507.  Function : It is possible to  let MTA create new archives that  will be
  6508.             encrypted with  a password.  In this  case, you  must supply
  6509.             the password  for the  target files,  which is  used as  the
  6510.             password for compression IF  the target system supports  any
  6511.             encryption in this way. Any target files with passwords  are
  6512.             (optionally)  recorded  in  a  log-file  (filename  and  the
  6513.             password). There is no counterpart in MTA.CTL BUT you  could
  6514.             use the xxxCompression options  to set a fixed  password (if
  6515.             needed).
  6516.  
  6517.             When you  use /OP  with a  password, you  can also  use some
  6518.             macros  inside  [password],  in  which  case  MTA  will do a
  6519.             substitution  of  the  macros.  The  following  macros   are
  6520.             available:
  6521.  
  6522.             $JD : Replaced by julian-date number. This is the number  of
  6523.                   days, counted from the  start of the year,  so January
  6524.                   31th  will  be  date-number  31,  February 2nd will be
  6525.                   number 33 and so on;
  6526.  
  6527.             $JY : Replaced by the  year-component. These are the last  2
  6528.                   bytes of the year (so 92 for 1992);
  6529.  
  6530.             $ND : The current day   (2 positions always);
  6531.  
  6532.             $NM : The current month (2 positions always);
  6533.  
  6534.             $NY : The current year  (4 positions always);
  6535.  
  6536.             $FN : The current filename (only name, not extension)
  6537.  
  6538.             /OP$JY$JDRvh will  create a  password of  92002Rvh when used
  6539.             on January  2nd 1992.  With this  macros you  can create any
  6540.             password you like, as long  as the target password (and  the
  6541.             supplied [password]) will NOT contain any spaces.
  6542.  
  6543.             /OP@ is a special form  of password usage for output  files.
  6544.             If you supply /OP@, MTA will generate a RANDOM password  for
  6545.             every file it  converts. In this  case the logging  of these
  6546.             passwords is mandatory otherwise you would never know  which
  6547.             passwords were assigned to which files. These IS some  usage
  6548.             for this option.  You can allow  users to download  ANYTHING
  6549.             from your system but they  can only use the files  when they
  6550.             obtain the  password in  another way  (by calling  you on  a
  6551.             separate line, by paying you in which case you can send  the
  6552.             passwords by mail etc.);
  6553.  
  6554.  ┌─────────────────────────────────────────────────────────────────────┐
  6555.  │ /ALT                                                                │
  6556.  └─────────────────────────────────────────────────────────────────────┘
  6557.  Function : When you  have set  SPECIAL versions  of archivers (see  the
  6558.             xxxPath and xxxVersion options in MTA.CTL) that can be  used
  6559.             (on  request)  for  testing  or  swift  conversion,  you can
  6560.             select THESE  versions (which  are not  the normal versions)
  6561.             by  using  the  /ALT  command-line  parameter.  When /ALT is
  6562.             used, MTA will look if an alternate version of any  archiver
  6563.             is set and will, if set, this version (if needed). If  there
  6564.             is  no  special  version  set,  /ALT  will  cause the normal
  6565.             version to be  used. See the  chapter on using  new versions
  6566.             of archivers;
  6567.  
  6568.  ┌─────────────────────────────────────────────────────────────────────┐
  6569.  │ /SIM                                                                │
  6570.  └─────────────────────────────────────────────────────────────────────┘
  6571.  Function : This  option  can  be   used  to  execute  MTA in a kind  of
  6572.             simulate mode. For  each archive to  be converted, MTA  will
  6573.             do the following:
  6574.  
  6575.             - Decompress the file;
  6576.             - Scan for Virus;
  6577.             - Call exits;
  6578.  
  6579.             This option  comes in  handy when  you execute  MTA under  a
  6580.             door inside  a BBS  (FileDoor) to  look for  a virus  inside
  6581.             files,  the  moment  the  file  is  uploaded or to check you
  6582.             files  (without  a  convert)  when  a  new  virus-scanner is
  6583.             released.   There   is  no  counterpart   option  for   this
  6584.             command-line parameter in the MTA.CTL file;
  6585.  
  6586.  ┌─────────────────────────────────────────────────────────────────────┐
  6587.  │ /REMSIM                                                             │
  6588.  └─────────────────────────────────────────────────────────────────────┘
  6589.  Function : This option can be used to create a file called MTAVANSI.xxx
  6590.             (where xxx is equal  to the MTA-task number, by default this
  6591.             will be 001). After MTA  has  finished, you can use DOS TYPE
  6592.             to list the file. You  will see what otherwise a remote call
  6593.             would have seen when  MTA  would  have been used under a BBS
  6594.             door (like  FileDoor  <tm>). You  can  use several runs with
  6595.             /REMSIM to adjust  the  remote  colors  to  your own taste !
  6596.  
  6597.             If you do not delete the  MTAVANSI.xxx  file  yourself,  MTA
  6598.             will append to that  file  if  /REMSIM is used again and the
  6599.             file is still in place (by  default, MTA will place the file
  6600.             in the CURRENT directory).
  6601.  
  6602.  
  6603.  ┌─────────────────────────────────────────────────────────────────────┐
  6604.  │ /DATE                                                               │
  6605.  └─────────────────────────────────────────────────────────────────────┘
  6606.  Function : This  option  can  be   used  to  execute  MTA in a kind  of
  6607.             simulate mode. For  each archive to  be converted, MTA  will
  6608.             do the following:
  6609.  
  6610.            - Test if the file matches any mask;
  6611.  
  6612.            - If it does,  test if the date  is lower than the  date that
  6613.              you supplied in the DelOldFiles option;
  6614.  
  6615.            - If it  does, manipulate the  file (delete, move)  depending
  6616.              on the DelOldPath option;
  6617.  
  6618.            This option  comes in  handy when  you execute  MTA to remove
  6619.            (without  conversion)  all  your  files  that  are too old to
  6620.            keep.
  6621.  
  6622.  ┌─────────────────────────────────────────────────────────────────────┐
  6623.  │ /ANS[type]                                                          │
  6624.  └─────────────────────────────────────────────────────────────────────┘
  6625.  Function : When this  command-line parameter  is NOT  set AND MTA  will
  6626.             use remote  logging, MTA  will use  ANSI sequences.  This is
  6627.             also  the  case  when  you  code  any  value from 1 to 9 for
  6628.             [type].  If  you  use  the  value  0 for [type] MTA will use
  6629.             ASCII for remote logging;
  6630.  
  6631.  ┌─────────────────────────────────────────────────────────────────────┐
  6632.  │ /D{=d:}                                                             │
  6633.  └─────────────────────────────────────────────────────────────────────┘
  6634.  Function : With this parameter  you instruct MTA to start  the diskette
  6635.             support as described before. There is no alternative  option
  6636.             for  it  in  MTA.CTL.   When  you  use  /D,  MTA  will start
  6637.             diskette  support  for  DRIVE  A:.   If  your  diskettes are
  6638.             accessed from another  drive (eg.   B:), you must  use /D=B:
  6639.             to do so;
  6640.  
  6641.  
  6642.  4.1.2 Command-line parameters that overrule/toggle/disable MTA.CTL
  6643.  ───────────────────────────────────────────────────────────────────────
  6644.  The following command-line parameters  will either switch an  option in
  6645.  MTA.CTL on, off  or will act  like a toggle.  Some can overrule  values
  6646.  that are set in MTA.CTL.
  6647.  
  6648.  
  6649.  ┌─────────────────────────────────────────────────────────────────────┐
  6650.  │ /DEBUG{file}                                                        │
  6651.  └─────────────────────────────────────────────────────────────────────┘
  6652.  Function : See MTADEBUG.TEC inside the supplied MTA__TEC.EXE file for a
  6653.             discription of this option.
  6654.  
  6655.  ┌─────────────────────────────────────────────────────────────────────┐
  6656.  │ /ARC                                                                │
  6657.  │ /ARJ                                                                │
  6658.  │ /ARJSFX                                                             │
  6659.  │ /DWC                                                                │
  6660.  │ /HYP                                                                │
  6661.  │ /LZH                                                                │
  6662.  │ /LZHSFX                                                             │
  6663.  │ /LZS                                                                │
  6664.  │ /MD                                                                 │
  6665.  │ /OWN                                                                │
  6666.  │ /PAK                                                                │
  6667.  │ /PAKSFX                                                             │
  6668.  │ /SQZ                                                                │
  6669.  │ /SQZSFX                                                             │
  6670.  │ /ZIP                                                                │
  6671.  │ /ZIPSFX                                                             │
  6672.  │ /ZOO                                                                │
  6673.  │ /PKLITE                                                             │
  6674.  │ /UNPKLITE                                                           │
  6675.  │ /GIFLITE                                                            │
  6676.  │ /GIF2JPG                                                            │
  6677.  │ /JPG2GIF                                                            │
  6678.  │ /GIF                                                                │
  6679.  └─────────────────────────────────────────────────────────────────────┘
  6680.  Function : Normally MTA will  convert all matched (and selected)  files
  6681.             to the system you assigned to the CompressionType option  in
  6682.             MTA.CTL. With these  command-line switches you  can overrule
  6683.             them with another format  (see CompressionType option for  a
  6684.             description of the various supported targets);
  6685.  
  6686.  ┌─────────────────────────────────────────────────────────────────────┐
  6687.  │ /NO4DOS                                                             │
  6688.  └─────────────────────────────────────────────────────────────────────┘
  6689.  Function : When you  run under  4DOS <tm>  and you  want to  use  MTA's
  6690.             internal move  options, you   can overrule  the 4DOS    <tm>
  6691.             MOVE command   with   this   parameter.   It   has the  same
  6692.             meaning  as  when  you  include  the  Not4DOSAware option in
  6693.             MTA.CTL.
  6694.  
  6695.  ┌─────────────────────────────────────────────────────────────────────┐
  6696.  │ /W{directory}                                                       │
  6697.  └─────────────────────────────────────────────────────────────────────┘
  6698.  Function : When you  have included  DefaultPath (or  alike) options  in
  6699.             MTA.CTL, or you wish  to convert files in  another directory
  6700.             as the current, you can include /W. /W by itself will  over-
  6701. │           rule  any  DefaultPath  (or  alike, like BBSPaths) option in
  6702.             MTA.CTL  and  will  force  MTA  to  work  inside the CURRENT
  6703.             directory. /W{directory}  (so you  append a  valid directory
  6704.             to the parameter, like /WD:\ZIP)  will force MTA to work  on
  6705.             the supplied directory;
  6706.  
  6707.  ┌─────────────────────────────────────────────────────────────────────┐
  6708.  │ /TOUCHC{+days}                                                      │
  6709.  │ /TOUCHH                                                             │
  6710.  │ /TOUCHL                                                             │
  6711.  │ /TOUCHF                                                             │
  6712.  └─────────────────────────────────────────────────────────────────────┘
  6713.  Function : One of  these command-line  parameters can  be used (if  you
  6714.             use multiple at the same time, only the last will count)  to
  6715.             overrule the touching system that MTA uses. If you have  set
  6716.             a  way  of  touching  (TouchHig,  TouchCur, TouchLow) in the
  6717.             MTA.CTL,  these  parameters  can  be  used  to overrule this
  6718.             option in the following way:
  6719.  
  6720.             /TOUCHC : Converted  files  will  get the current date (or a
  6721.                       date {+days} (for example /TOUCHC+10 for +10 days)
  6722.                       away from the current-date;
  6723.  
  6724.             /TOUCHH  : The  same  as  using TouchHig in MTA.CTL (use the
  6725.                        highest date inside the archive);
  6726.  
  6727.             /TOUCHL : The  same as using TouchLow in in MTA.CTL (use the
  6728.                       lowest date inside the archive);
  6729.  
  6730.             /TOUCHF :  Files will keep the same date as they  had before
  6731.                        the conversion started;
  6732.  
  6733.  ┌─────────────────────────────────────────────────────────────────────┐
  6734.  │ /M{directory}                                                       │
  6735.  └─────────────────────────────────────────────────────────────────────┘
  6736.  Function : If you  use the MoveToDir option  in MTA.CTL you can  use /M
  6737.             on its own to make that option inactive. If you also  append
  6738.             a directory (eg. /MD:\ZIP\TRA), it will work the same as  if
  6739.             you supplied  D:\ZIP\TRA as  the directory  in this  option.
  6740.             So  /MD:\ZIP\TRA  will  move  converted  files to D:\ZIP\TRA
  6741.             even when the MoveToDir  option in MTA.CTL is  set otherwise
  6742.             or when it is not set at all;
  6743.  
  6744.  ┌─────────────────────────────────────────────────────────────────────┐
  6745.  │ /C2G[options]                                                       │
  6746.  │ /C2J[options]                                                       │
  6747.  │ /CD[options]                                                        │
  6748.  │ /CGL[options]                                                       │
  6749.  │ /CH[options]                                                        │
  6750.  │ /CHS[options]                                                       │
  6751.  │ /CJ[options]                                                        │
  6752.  │ /CJS[options]                                                       │
  6753.  │ /CL[options]                                                        │
  6754.  │ /CQ[options]                                                        │
  6755.  │ /CS[options]                                                        │
  6756.  │ /CSS[options]                                                       │
  6757.  │ /CZ[options]                                                        │
  6758.  │ /CZS[options]                                                       │
  6759.  │ /CGT[options]                                                       │
  6760.  └─────────────────────────────────────────────────────────────────────┘
  6761.  Function : For  almost all archivers  (and GIF-alike programs)  you can
  6762.             add some extra options for  each and every archiver (or  GIF
  6763.             program).  These  options  can  be  found  in MTA.CTL as the
  6764.             xxxCompression options (see over there). You can also  over-
  6765.             rule them (or add them  on the fly) with these  command-line
  6766.             parameters. [options]  must be  the added  options for  that
  6767.             archiver. Spaces must be replaced by underscore  characters,
  6768.             so '-a -z'  must be coded  as '-a_-z' (without  the quotes).
  6769.             Each of the command-line parameter stands for:
  6770.  
  6771.             - /C2G        GIF2JPG
  6772.             - /C2J        JPG2GIF
  6773.             - /CD         DWC
  6774.             - /CGL        GIFLITE
  6775.             - /CH         LZH
  6776.             - /CHS        LZH (SFX)
  6777.             - /CJ         ARJ
  6778.             - /CJS        ARJ (SFX)
  6779.             - /CL         PKLITE
  6780.             - /CQ         ZOO
  6781.             - /CS         SQZ
  6782.             - /CSS        SQZ (SFX)
  6783.             - /CZ         ZIP
  6784.             - /CZS        ZIP2EXE (ZIP SFX)
  6785.             - /CGT        GIFTEST
  6786.  
  6787.             Refer to the documentation for  each archiver to see a  list
  6788.             of non-common options that  can be used. Also  remember that
  6789.             the SFX creation is done  AFTER the compression (and NOT  at
  6790.             the  same  time,  even  if  the compression program supports
  6791.             it).   This means  that adding  something for  LZH SFX  will
  6792.             cause that it will  ONLY be used to  create the SFX and  NOT
  6793.             for  the  compression  of  the  LZH-file  (same goes for all
  6794.             other SFX's);
  6795.  
  6796.  ┌─────────────────────────────────────────────────────────────────────┐
  6797.  │ /Z{path}                                                            │
  6798.  └─────────────────────────────────────────────────────────────────────┘
  6799.  Function :  This command-line  parameter has  the same  meaning as  the
  6800.             usage of  the AutoDescription  option in  MTA.CTL. When  you
  6801.             use /Z as is, the AutoDescription option (if set) is  turned
  6802.             off and no  comments will be  added. When you  append a path
  6803.             (the drive,  directory and  filename) to  the parameter, the
  6804.             file  that  you  supply  will  be  added  as  comment to all
  6805.             converted archives that support  these comments. As such  it
  6806.             can be  used to  (temporary) add  the AutoDescription  or to
  6807.             overrule the values set in MTA.CTL;
  6808.  
  6809.  ┌─────────────────────────────────────────────────────────────────────┐
  6810.  │ /CARCOM{n}                                                          │
  6811.  └─────────────────────────────────────────────────────────────────────┘
  6812.  Function : This command-line option can be used to change the  behavior
  6813.             of the CarryComment  option in MTA.CTL  (if set).   When you
  6814.             supply /CARCOM  as is,  the CarryComment  option in  MTA.CTL
  6815.             will  be  (temporary)  switched  off.  If  you  use /CARCOMn
  6816.             (where 'n' is  the number 1,  2 or 3),  you can (re)set  the
  6817.             function of the CarryComment option for this run;
  6818.  
  6819.  ┌─────────────────────────────────────────────────────────────────────┐
  6820.  │ /AFB                                                                │
  6821.  │ /AFB- or /AFB+                                                      │
  6822.  └─────────────────────────────────────────────────────────────────────┘
  6823.  Function : This command-line parameter is a toggle for the  AddFilesBBS
  6824.             option in MTA.CTL;
  6825.  
  6826.  ┌─────────────────────────────────────────────────────────────────────┐
  6827.  │ /P                                                                  │
  6828.  └─────────────────────────────────────────────────────────────────────┘
  6829.  Function : When  you use the  /P command-line parameter,  MTA will stop
  6830.             any logging in  the normal log-file(s)  for the duration  of
  6831.             the run.
  6832.  
  6833.  ┌─────────────────────────────────────────────────────────────────────┐
  6834.  │ /DI                                                                 │
  6835.  │ /DE                                                                 │
  6836.  │ /DD                                                                 │
  6837.  └─────────────────────────────────────────────────────────────────────┘
  6838.  Function :  You can  disable the  functions of  the options IncludeFile
  6839.             (/DI), ExcludeFile  (/DE) and  the DoNot  (/DD) options with
  6840.             help of these command-line parameters;
  6841.  
  6842.  ┌─────────────────────────────────────────────────────────────────────┐
  6843.  │ /E1                                                                 │
  6844.  │ /E2                                                                 │
  6845.  │ /EB                                                                 │
  6846.  │ /EG                                                                 │
  6847.  └─────────────────────────────────────────────────────────────────────┘
  6848.  Functions : Any  exit  you   have  declared, can be disabled. /E1  will
  6849.              disable ExitBeforeFill (if set),  /E2 will do the  same for
  6850.              ExitAfterFill (if set),  /EB for ExitBetweenConversion  and
  6851.              /EG for  ExitAfterCompression. Exits  can only  be SET with
  6852.              help of options in MTA.CTL;
  6853.  
  6854.  ┌─────────────────────────────────────────────────────────────────────┐
  6855.  │ /U                                                                  │
  6856.  │ /U[filename]                                                        │
  6857.  │ /U[path]                                                            │
  6858.  └─────────────────────────────────────────────────────────────────────┘
  6859.  Function : This  command-line   parameter  comes in three flavors.  The
  6860.             first, /U, is a toggle  for the FilesBBS option in  MTA.CTL.
  6861.             /U will  disable the  option if  it was  set in  MTA.CTL and
  6862.             will enable the option if it was not set.
  6863.  
  6864.             /U[filename] will  enable the  FilesBBS option  but in  this
  6865.             case you  overrule the  filename FILES.BBS  (in the  working
  6866.             directory) with [filename].
  6867.  
  6868.             /U[path] will enable  the FilesBBS option  but in this  case
  6869.             you overrule the filename  FILES.BBS AND the fact  that this
  6870.             file  must  reside  in  EACH  working directory with [path].
  6871.             [path] is  the SINGLE  filename (with  drive and  directory)
  6872.             that MTA will update (RBBS master directory and such);
  6873.  
  6874.  ┌─────────────────────────────────────────────────────────────────────┐
  6875.  │ /NOOLD                                                              │
  6876.  └─────────────────────────────────────────────────────────────────────┘
  6877.  Function : When  you added the  DelOldFiles option to  MTA.CTL, you can
  6878.             use /NOOLD to switch the option off.
  6879.  
  6880.  ┌─────────────────────────────────────────────────────────────────────┐
  6881.  │ /UPGRADE                                                            │
  6882.  │ /UPGRADE+ or /UPGRADE-                                              │
  6883.  └─────────────────────────────────────────────────────────────────────┘
  6884.  Function : This command-line parameter is a toggle for the  OnlyUpgrade
  6885.             option in MTA.CTL;
  6886.  
  6887.  ┌─────────────────────────────────────────────────────────────────────┐
  6888.  │ /SBA                                                                │
  6889.  │ /SBA+ or /SBA-                                                      │
  6890.  └─────────────────────────────────────────────────────────────────────┘
  6891.  Function : This command-line parameter is a toggle for the  SkipBackups
  6892.             option in MTA.CTL;
  6893.  
  6894.  ┌─────────────────────────────────────────────────────────────────────┐
  6895.  │ /NFC or /NFC-                                                       │
  6896.  └─────────────────────────────────────────────────────────────────────┘
  6897.  Function : This command-line  parameter  toggles   the  FIXEDCONVERSION
  6898.             option in MTA.CTL  to  off. You  can  not toggle this option
  6899.             to ON. When FIXEDCONVERSION options are set in MTA.CTL, they
  6900.             are set ON by default.
  6901.  
  6902.  ┌─────────────────────────────────────────────────────────────────────┐
  6903.  │ /NUU or /NUU-                                                       │
  6904.  └─────────────────────────────────────────────────────────────────────┘
  6905.  Function : This command-line parameter  toggles  the UPDATEUNTYPEDFILES
  6906.             option to off (on is not possible);
  6907.  
  6908.  ┌─────────────────────────────────────────────────────────────────────┐
  6909.  │ /NUM or /NUM-                                                       │
  6910.  └─────────────────────────────────────────────────────────────────────┘
  6911.  Function : This  command-line  parameter   toggles  the  UPDATEMSGFILES
  6912.             option to off (on is not possible);
  6913.  
  6914.  ┌─────────────────────────────────────────────────────────────────────┐
  6915.  │ /NUT or /NUT-                                                       │
  6916.  └─────────────────────────────────────────────────────────────────────┘
  6917.  Function : This  command-line  parameter  toggles  the  UPDATETICKFILES
  6918.             option to off (on is not possible);
  6919.  
  6920.  ┌─────────────────────────────────────────────────────────────────────┐
  6921.  │ /NUF or /NUF-                                                       │
  6922.  └─────────────────────────────────────────────────────────────────────┘
  6923.  Function : This  command-line  parameter   toggles  the  UPDATEFESFILES
  6924.             option to off (on is not possible);
  6925.  
  6926.  ┌─────────────────────────────────────────────────────────────────────┐
  6927.  │ /NMA or /NMA-                                                       │
  6928.  └─────────────────────────────────────────────────────────────────────┘
  6929.  Function : This  command-line  parameter toggles the  MAKEARC option to
  6930.             off (on is not possible);
  6931.  
  6932.  ┌─────────────────────────────────────────────────────────────────────┐
  6933.  │ /NME or /NME-                                                       │
  6934.  └─────────────────────────────────────────────────────────────────────┘
  6935.  Function : This  command-line  parameter   toggles  the  MAKEARCEXCLUDE
  6936.             option to off (on is not possible);
  6937.  
  6938.  ┌─────────────────────────────────────────────────────────────────────┐
  6939.  │ /NOB                                                                │
  6940.  │ /NOB+ or /NOB-                                                      │
  6941.  └─────────────────────────────────────────────────────────────────────┘
  6942.  Function : This  command-line  parameter   is  a toggle for the  NoBeep
  6943.             option in MTA.CTL;
  6944.  
  6945.  ┌─────────────────────────────────────────────────────────────────────┐
  6946.  │ /NVI                                                                │
  6947.  └─────────────────────────────────────────────────────────────────────┘
  6948.  Function : This command-line parameter  will  switch of  the configured
  6949.             virus scanners for the duration of this run.
  6950.  
  6951.  ┌─────────────────────────────────────────────────────────────────────┐
  6952.  │ /NVM                                                                │
  6953.  └─────────────────────────────────────────────────────────────────────┘
  6954.  Function : This command-line parameter  will  switch of  the configured
  6955.             masks that  limit  the scan for a virus. If /NVM is supplied
  6956.             and the VirusScanner  options  are  available and active (no
  6957.             usage of /NVI), the scan  is ALWAYS  performed on EVERY file
  6958.             in EVERY archive.
  6959.  
  6960.  ┌─────────────────────────────────────────────────────────────────────┐
  6961.  │ /NOEMS                                                              │
  6962.  │ /NOXMS                                                              │
  6963.  └─────────────────────────────────────────────────────────────────────┘
  6964.  Function : This command-line  parameters can  be used  to disable   the
  6965.             usage of EMS  and/or XMS. The  same can be  done permanently
  6966.             with the NoEMS and/or NoXMS options in MTA.CTL;
  6967.  
  6968.  ┌─────────────────────────────────────────────────────────────────────┐
  6969.  │ /VMODE{mode}                                                        │
  6970.  └─────────────────────────────────────────────────────────────────────┘
  6971.  Function : /VMODE  as is, will  switch any VideoMode  option in MTA.CTL
  6972.             to OFF.  /VMode{mode} (where  {mode} is  the DECIMAL  video-
  6973.             mode) will force MTA to switch the video-card to {mode};
  6974.  
  6975.  ┌─────────────────────────────────────────────────────────────────────┐
  6976.  │ /EXTTST                                                             │
  6977.  │ /EXTTST+ or /EXTTST-                                                │
  6978.  └─────────────────────────────────────────────────────────────────────┘
  6979.  Function : /EXTTST is used  as a toggle for the  ExtendedTesting option
  6980.             in MTA.CTL.
  6981.  
  6982.  ┌─────────────────────────────────────────────────────────────────────┐
  6983.  │ /SFX                                                                │
  6984.  │ /SFX+ or /SFX-                                                      │
  6985.  └─────────────────────────────────────────────────────────────────────┘
  6986.  Function : /SFX  is  used  as  a  toggle  for  the SFXFiles option in
  6987.             MTA.CTL;
  6988.  
  6989.  ┌─────────────────────────────────────────────────────────────────────┐
  6990.  │ /LEA                                                                │
  6991.  │ /LEA+ or /LEA-                                                      │
  6992.  └─────────────────────────────────────────────────────────────────────┘
  6993.  Function : /LEA is  used as  a toggle  for the  KeepAbnormalExtensions
  6994.             option in MTA.CTL;
  6995.  
  6996.  ┌─────────────────────────────────────────────────────────────────────┐
  6997.  │ /TIM                                                                │
  6998.  └─────────────────────────────────────────────────────────────────────┘
  6999.  Function : When  you use the  /TIM command-line parameter,  you disable
  7000.             the RunTime option in MTA.CTL (if set);
  7001.  
  7002.  ┌─────────────────────────────────────────────────────────────────────┐
  7003.  │ /NEW                                                                │
  7004.  │ /NEW+ or /NEW-                                                      │
  7005.  └─────────────────────────────────────────────────────────────────────┘
  7006.  Function : /NEW is  used as  a toggle  for the  OnlyNewFiles option in
  7007.             MTA.CTL;
  7008.  
  7009.  ┌─────────────────────────────────────────────────────────────────────┐
  7010.  │ /MAR                                                                │
  7011.  │ /MAR+ or /MAR-                                                      │
  7012.  └─────────────────────────────────────────────────────────────────────┘
  7013.  Function : /MAR  is  used  as   a  toggle  for  the NoMarked option  in
  7014.             MTA.CTL;
  7015.  
  7016.  ┌─────────────────────────────────────────────────────────────────────┐
  7017.  │ /MAH{string}                                                        │
  7018.  └─────────────────────────────────────────────────────────────────────┘
  7019.  Function : If you want to  change the value for the MarkHeader  option,
  7020.             you can use the  /MAH{string} command-line option. When  you
  7021.             do  not  supply  {string},  MTA  will  be  forced to use the
  7022.             default value. When used, {string} must be 6 bytes of less;
  7023.  
  7024.  ┌─────────────────────────────────────────────────────────────────────┐
  7025.  │ /MAS{string}                                                        │
  7026.  └─────────────────────────────────────────────────────────────────────┘
  7027.  Function : If you want to  change the value for the MarkString  option,
  7028.             you can use the  /MAS{string} command-line option. When  you
  7029.             do  not  supply  {string},  MTA  will  be  forced to use the
  7030.             default  value.  When  used,  {string}  must  be 14 bytes of
  7031.             less;
  7032.  
  7033.  ┌─────────────────────────────────────────────────────────────────────┐
  7034.  │ /UNMARK                                                             │
  7035.  │ /UNMARK+ or /UNMARK-                                                │
  7036.  └─────────────────────────────────────────────────────────────────────┘
  7037.  Function : /UNMARK  is  used  as   a  toggle  for the UnMark option  in
  7038.             MTA.CTL;
  7039.  
  7040.  ┌─────────────────────────────────────────────────────────────────────┐
  7041.  │ /NOOWNMARK                                                          │
  7042.  └─────────────────────────────────────────────────────────────────────┘
  7043.  Function : /NOOWNMARK should only be used when MTA is executed under a
  7044.             protocol  driver like FIleDoor <tm> (XFD). In this case, the
  7045.             incomming (uploaded) files are checked against your own mark
  7046.             that you  use with NoMarked/MarkString. If the file contains
  7047.             the same mark, MTA will delete the file at once. This option
  7048.             will stop  those  users who download a file from you, rename
  7049.             the file to a bogus-name and upload it again. The dupe-check
  7050.             will not deny such a file, but MTA can see that it is one of
  7051.             your own files. If  you  use  /NOOWNMARK  you should make it
  7052.             sure that you are NOT using the DEFAULT  mark-string but one
  7053.             of your own !!
  7054.  
  7055.  ┌─────────────────────────────────────────────────────────────────────┐
  7056.  │ /OOA                                                                │
  7057.  │ /OOA+ or /OOA-                                                      │
  7058.  └─────────────────────────────────────────────────────────────────────┘
  7059.  Function : Using /OOA  will do  the same  as using  the  OptimizeOnSize
  7060.             option in MTA.CTL;
  7061.  
  7062.  ┌─────────────────────────────────────────────────────────────────────┐
  7063.  │ /AIA                                                                │
  7064.  │ /AIA+ or /AIA-                                                      │
  7065.  └─────────────────────────────────────────────────────────────────────┘
  7066.  Function : /AIA  is  used   as  a  toggle for the NoArcInArc  option in
  7067.             MTA.CTL;
  7068.  
  7069.  ┌─────────────────────────────────────────────────────────────────────┐
  7070.  │ /KEEPAV                                                             │
  7071.  │ /KEEPAV+ or /KEEPAV-                                                │
  7072.  └─────────────────────────────────────────────────────────────────────┘
  7073.  Function : /KEEPAV  is  used  as   a  toggle  for the KeepAV option  in
  7074.             MTA.CTL;
  7075.  
  7076.  ┌─────────────────────────────────────────────────────────────────────┐
  7077.  │ /KEEPVL                                                             │
  7078.  │ /KEEPVL+ or /KEEPVL-                                                │
  7079.  └─────────────────────────────────────────────────────────────────────┘
  7080.  Function : /KEEPVL  is  used  as   a  toggle  for the KeepVL option  in
  7081.             MTA.CTL;
  7082.  
  7083.  ┌─────────────────────────────────────────────────────────────────────┐
  7084.  │ /NOCLOAK                                                            │
  7085.  │ /NOCLOAD+ or /NOCLOAK-                                              │
  7086.  └─────────────────────────────────────────────────────────────────────┘
  7087.  Function : /NOCLOAK  is  used  as  a  toggle  for the NoCloakedArchives
  7088.             option in MTA.CTL;
  7089.  
  7090.  ┌─────────────────────────────────────────────────────────────────────┐
  7091.  │ /ALL                                                                │
  7092.  │ /ALL+ or /ALL-                                                      │
  7093.  └─────────────────────────────────────────────────────────────────────┘
  7094.  Function : /ALL is used as a toggle for the AllDisketteFiles option  in
  7095.             MTA.CTL;
  7096.  
  7097.  ┌─────────────────────────────────────────────────────────────────────┐
  7098.  │ /BAUD[baudrate]                                                     │
  7099.  │ /COM[comport]                                                       │
  7100.  │ /FOSSIL[fossilport]                                                 │
  7101.  │ /REMOTE                                                             │
  7102.  └─────────────────────────────────────────────────────────────────────┘
  7103.  Function : When MTA is used under a door inside a BBS and you want  MTA
  7104.             to keep the user informed about the current status, you  can
  7105.             use /BAUD, /COM (or /PORT) and /REMOTE (or their  equivalent
  7106.             counterparts in  MTA.CTL) to  do so.  [baudrate] can  be the
  7107.             baudrate  (locked  or  not)  or  0  (in which case NO remote
  7108.             operations will be done). [comport] can be a valid COM  port
  7109.             or 0 (in which case  no remote operations will take  place).
  7110.             [fossilport]  must  be  the  valid  fossil-port, there is no
  7111.             value to  switch remote  operations off  other than  setting
  7112.             [baudrate] to 0.  /COM is preferred.  You can use  all these
  7113.             command-line parameters (or  their counterparts in  MTA.CTL)
  7114.             but they  will do  nothing unless  the following combination
  7115.             is  made  (where  the  command-line  parameters overrule any
  7116.             options in MTA.CTL):
  7117.  
  7118.             - /BAUD (Baudrate) must be set to a non-zero value;
  7119.             - /COM  (ComPort )  ,,  ,,  ,, ,,    ,,  ,,    ,,  OR
  7120.               /FOSSIL (FossilPort) must be used;
  7121.             - /REMOTE (Remote) is used;
  7122.  
  7123.             You should  also look  into the  /ANS command-line parameter
  7124.             in the previous (sub)chapter.
  7125.  
  7126.  ┌─────────────────────────────────────────────────────────────────────┐
  7127.  │ /STOSIZ{ext}                                                        │
  7128.  └─────────────────────────────────────────────────────────────────────┘
  7129.  Function : /STOSIZ  is  used   as  a  toggle  for the  StoreSize option
  7130.             MTA.CTL. When you use this  option to SET the option  to ON,
  7131.             {ext} (optional)  can be  used to  set the  extension of the
  7132.             semaphore file  (default XS1)  to something  else (F#D  when
  7133.             running FileDoor 2.03 or older betas);
  7134.  
  7135.  ┌─────────────────────────────────────────────────────────────────────┐
  7136.  │ /STONAM{nam}                                                        │
  7137.  └─────────────────────────────────────────────────────────────────────┘
  7138.  Function : /STONAM  is  used   as  a  toggle  for the  StoreName option
  7139.             MTA.CTL. When you use this  option to SET the option  to ON,
  7140.             {nam} (optional)  can be  used to  set the  filename of  the
  7141.             semaphore  file  (default  FILEDOOR.XS2)  to  something else
  7142.             (FILEDOOR.F#D when running older FileDoor betas);
  7143.  
  7144.  ┌─────────────────────────────────────────────────────────────────────┐
  7145.  │ /STOCOM{nam}                                                        │
  7146.  └─────────────────────────────────────────────────────────────────────┘
  7147.  Function : /STOCOM is used  as  a  toggle  for the  StoreComment option
  7148.             MTA.CTL. When you use this  option to SET the option  to ON,
  7149.             {nam} (optional)   can  be   used  to   set the  name of the
  7150.             semaphore file (default FILEDOOR.XS3) to something else.
  7151.  
  7152.  
  7153.  
  7154.  
  7155.  4.1.3 Command-line parameters with a special usage
  7156.  ───────────────────────────────────────────────────────────────────────
  7157.  The following command-line parameters  are special (should not  be used
  7158.  but  are  documented  to  be  complete)  or  are only used in debugging
  7159.  situations.
  7160.  
  7161.  
  7162.  ┌─────────────────────────────────────────────────────────────────────┐
  7163.  │ /|                                                                  │
  7164.  │ />                                                                  │
  7165.  │ /<                                                                  │
  7166.  └─────────────────────────────────────────────────────────────────────┘
  7167.  Function : These options should (and can not) be used. They can not  be
  7168.             executed  from  the  DOS  command-line  because  they   have
  7169.             something to do  with piping. These  command-line parameters
  7170.             are used by MTA internally !
  7171.  
  7172.  ┌─────────────────────────────────────────────────────────────────────┐
  7173.  │ /PAUSE                                                              │
  7174.  └─────────────────────────────────────────────────────────────────────┘
  7175.  Function : Sometimes MTA will execute a program (archiver, virus  scan,
  7176.             exit  and  so  on)  and  this  programs reports an error. In
  7177.             these cases  you are  not able  to see  what happens because
  7178.             MTA  will  go  on  (after  a  warning  is given). If you use
  7179.             /PAUSE, MTA will pause  (without clearing the screen)  after
  7180.             the shell returns to MTA.  You must press [ESC] to  continue
  7181.             MTA in the normal way;
  7182.  
  7183.  
  7184.  
  7185.  4.2 Aborting MTA
  7186.  ───────────────────────────────────────────────────────────────────────
  7187.  There is only one way to abort MTA before it's normal end. When MTA  is
  7188.  busy, you  can press  [ESC]. MTA  will (in  time) display  that it will
  7189.  terminate soon.  Termination will  be done  AFTER THE  CURRENT FILE  IS
  7190.  CONVERTED !
  7191.  
  7192.  When you did  press [ESC] by  mistake, you can  always press any  other
  7193.  key  to  release  the  pending  termination.  In  that  case,  MTA will
  7194.  continue as normal.
  7195.  
  7196.  The termination option  does NOT work  when you use  the /D switch.  In
  7197.  this case you must wait until the diskette is fully converted.
  7198.  
  7199.  
  7200.  
  7201.  4.3 LOG file
  7202.  ───────────────────────────────────────────────────────────────────────
  7203.  MTA makes a log of almost  everything (unless you specify NoLog in  the
  7204.  MTA.CTL file or supply  /L as a runtime  switch).  You can  browse thru
  7205.  the log with a program like V.Buerg's LIST or with the 'good old'  TYPE
  7206.  command.
  7207.  
  7208.  The log-style can  be adjusted to  the users need  with three different
  7209.  options  (LogStyleFormat,  LogDateFormat  and  LogTimeFormat). Also you
  7210.  can combine  all possible  logs (the  'normal' log,  called MTA.LOG  by
  7211.  default, the  password log,  called MTA.PWN  by default  and the random
  7212.  password log,  called MTA.PWD  by default)  into one  log-file, because
  7213.  MTA will open  (APPEND) and close  the log for  every record it  has to
  7214.  write.
  7215.  
  7216.  Depending on the number of files  MTA has to convert, the MTA.LOG  file
  7217.  can get very large. I have  supplied a program (MTL.EXE) to solve  this
  7218.  problem. With  MTL.EXE you  can make  a statistical  review of your log
  7219.  file. In addition,  you can instruct  MTL to shorten  the log-file. MTL
  7220.  will rewrite the MTA.LOG file with only the total counters so far.  The
  7221.  next run MTL  will detect these  counters again and  adjust the current
  7222.  counters with these values.
  7223.  
  7224.  MTL depends  on the  format of  the log-file.  Therefor you  should not
  7225.  make any changes to the current  log-file, but make a copy of  the file
  7226.  and  work  on  the  copy  and  not  the original. MTL IS able to detect
  7227.  customized log-files  and will  adjust itself  to search  at the  right
  7228.  places. Also, records of a different  kind can be available in the  log
  7229.  (in case of a mailer or BBS program). MTL will skip these records  but.
  7230.  If  you  want  to  clean  the  log  with  MTL, MTL will ALSO remove all
  7231.  NON-MTA data from the log !
  7232.  
  7233.  If you get tired of the log, delete it, and MTA will create a new  one.
  7234.  When MTA calls itself as a child invocation, the child MTA does not  do
  7235.  any type of logging !
  7236.  
  7237.  
  7238.  
  7239.  4.4 Errors
  7240.  ───────────────────────────────────────────────────────────────────────
  7241.  Under some conditions, MTA can  abort (or skip files) which  causes the
  7242.  temporary directory to  stay on disk.  Normally MTA will  try to remove
  7243.  all files  from this  temporary directory  but there  can be cases when
  7244.  this is impossible. In such cases,  MTA will report this at the  end of
  7245.  the run. In that case you  must correct the errors manually and  remove
  7246.  the  directory  (or  directories)  from  disk. Under normal conditions,
  7247.  this  will  only  take  place  with  critical errors (disk failures and
  7248.  such).
  7249.  
  7250.  ┌───────┬─────────────────────────────────────────────────────────────┐
  7251.  │   5   │ Version information and credits                             │
  7252.  └───────┴─────────────────────────────────────────────────────────────┘
  7253.  
  7254.  5.1 The BETA-team
  7255.  ───────────────────────────────────────────────────────────────────────
  7256.  Look into  the file  SUPPORT.MTA for  a full  list of  all beta-testers
  7257.  and support nodes.
  7258.  
  7259.  
  7260.  
  7261.  5.2 Credits
  7262.  ───────────────────────────────────────────────────────────────────────
  7263.  Thanks  to  the  following  people  (besides  my eternal thanks for the
  7264.  BETA team):
  7265.  
  7266.  - All   paying, registered   users. You   made it   possible to enhance
  7267.    MTA with nice features;
  7268.  
  7269.  - All users who did write me bug reports, suggestions and so on;
  7270.  
  7271.  
  7272.  
  7273.  5.3 Version history
  7274.  ───────────────────────────────────────────────────────────────────────
  7275.  ┌───────┬────────────────────────────┐
  7276.  │ 11.xx │ Sampled release info       │
  7277.  └───────┴────────────────────────────┘
  7278.   ■ Bug fixes;
  7279.  
  7280.   ■ Added   FilesBBSFormat   option,   CarryComment   option,  alternate
  7281.     CTL support, combination of /M and /D allowed;
  7282.  
  7283.  
  7284.  ┌───────┬────────────────────────────┐
  7285.  │ 12.xx │ Sample release info        │
  7286.  └───────┴────────────────────────────┘
  7287.   ■ Bug fixes;
  7288.  
  7289.   ■ All  tables  to  255   entries,  tag-menu,  /@,  /MD,    AltDisplay,
  7290.     internal swapping   (SwapPath,  NoSwap),   MDCD  support   (MDPath),
  7291.     IncludeCTL, AV-aware,  encryption   aware,  configurable   log-file,
  7292.     MTAErrorPath, extended help, mouse  aware, ITS aware and  many, many
  7293.     more changes;
  7294.  
  7295.  
  7296.  ┌───────┬────────────────────────────┐
  7297.  │ 13.xx │ Sample release info        │
  7298.  └───────┴────────────────────────────┘
  7299.   ■ MTA swapped from  free-ware to shareware so  now a small price  must
  7300.     be payed for continued usage;
  7301.  
  7302.   ■ Several bugs fixed;
  7303.  
  7304.   ■ Added support for 4DOS descriptions, EGA/VGA special text-modes
  7305.  
  7306.  
  7307.  ┌───────┬────────────────────────────┐
  7308.  │ 14.xx │ Sample release info        │
  7309.  └───────┴────────────────────────────┘
  7310.   ■ Fixed some bugs;
  7311.  
  7312.   ■ Added  support  for  volume-labels  (ZIP/ARJ),  special   log-files,
  7313.     descriptions, substituted drives  (recursive support), VGA  support,
  7314.     special selections (/LVLx),  sharing and multi-tasking  (also multi-
  7315.     MTA), ARJ, multiple  virus scanners, HYP(er),  PKLITE, menu-tagging,
  7316.     better help, LZH 2.xx support, videomode, TICK, FES, untyped  files,
  7317.     simulation, macros in  the password command-line  parameters, remote
  7318.     logging, files that are too old, XARC/ARCE, ZOO 2.xx,
  7319.  
  7320.  
  7321.  ┌───────┬────────────────────────────┐
  7322.  │ 15.01 │ Major Release              │
  7323.  └───────┴────────────────────────────┘
  7324.   ■ I did  an almost complete  rewrite of the  documentation. Many cross
  7325.     references are now explained at their proper locations, old info  is
  7326.     removed  (a  couple  of  chapters),  all  options  and  command-line
  7327.     parameters  are  revised  and  (I  hope)  better explained. The only
  7328.     thing that still is  on the list, is  an index and a  proper utility
  7329.     to create the  page numbers for  the various users.  Overall the new
  7330.     documentation is  somewhat smaller  than the  previous version while
  7331.     still giving you all relevant information;
  7332.  
  7333.   ■ The  internals of  MTA have  changed completely.  This causes MTA to
  7334.     use almost  the same  amount of  memory as  before though  there are
  7335.     many options added.  There is also  a separate overlayed  version of
  7336.     MTA  available  (MTAOVR)  that  uses  100K  less  of  (conventional)
  7337.     memory;
  7338.  
  7339.   ■ There was  a serious bug  in the RAPATHS  option logic, causing  MTA
  7340.     not  to  recognize  the  FILES.RA  file.  This is fixed. The RAPATHS
  7341.     option is  somewhat changed  in syntax  and the  RA0 and RA1 options
  7342.     are removed from MTA;
  7343.  
  7344.   ■ The  dos-shell  in  MTA  (you  know, the little window) was  getting
  7345.     somewhat old for the current state  of the technique.  The same  was
  7346.     true for  the swapping  routines. They  are all  replaced and we now
  7347.     have 4  new DOS-shell  routines in  MTA (2  non swapped,  2 swapped,
  7348.     each pair consisting of  a windowed and non-windowed  routine). This
  7349.     also  causes  archivers  that  needed  a  swap,  to  stay inside the
  7350.     DOS-window  as  were  the  non-swapped  archivers.  Because of these
  7351.     changes the  STOWBUFFER and  FORCECGA options  are removed  from MTA
  7352.     and are now obsolete;
  7353.  
  7354.   ■ Changed  the logic  for AV'ed  files. Previous  versions would  give
  7355.     errors under special conditions. This problem is fixed;
  7356.  
  7357.   ■ Fixed a problem  where MTA could make  a mess of ARJ  AV'ed archives
  7358.     (if KEEPAV was  set) in combination  with AutoDescription. If  these
  7359.     conditions  were  met  (KEEPAV,  ARJ-AV,  AutoDescription)  and  the
  7360.     target was ZIP, MTA would  add a description to the  ARJ-file, using
  7361.     internal patching techniques, causing  the target-file to be  defect
  7362.     (you could still extract them, but with a warning). This is fixed;
  7363.  
  7364.   ■ Changed  the  logic  for  SFX  files. Previous versions did  contain
  7365.     their own  logic to  remove the  SFX-header from  the archives. This
  7366.     coding is removed  and MTA should  be able to  convert SFX files  if
  7367.     the  archiver  can  extract  files  from  the  SFX'ed  file.  By  my
  7368.     knowledge,  there  is  only  one  non-standard SFX-file. This is the
  7369.     ZOO-SFX created  with a  separate program.  These files  can not  be
  7370.     converted when ZOO  is not able  to decompress files  from the *.EXE
  7371.     files.  Overall,  this  will  give  a  much more secure (and version
  7372.     independent) result;
  7373.  
  7374.   ■ The  /M  (MOVETOPATH)  command-line  parameter  could  be used  with
  7375.     invalid directory names. MTA would report errors when the  converted
  7376.     files  was  actually  moved  to  this  directory  or a file would be
  7377.     renamed (convert RA_110.ZIP to ZIP,  with /MTRA where TRA was  not a
  7378.     valid directory.  The result  was a  file TRARA_11.ZIP  and the file
  7379.     was still  in the  current directory).  This logic  has been changed
  7380.     and fixed;  MTA will  now validate  the supplied  directory and will
  7381.     abort  (before  the  conversion)  if  there  is an invalid directory
  7382.     supplied;
  7383.  
  7384.   ■ Previous versions  of MTA could  not work with  generic directories.
  7385.     You  always  had  to  include  the  full pathname (directory and the
  7386.     drive   name).   When   reading   options   from   MTA.CTL  and  the
  7387.     command-line, MTA will  now expand generic  paths (/M.. or  /Z\ZIP\)
  7388.     to full names, based on  the current directory and drive.  Be warned
  7389.     though.  If  the  generic  path  results in an expanded NON-existing
  7390.     path, MTA will abort with an error;
  7391.  
  7392.   ■ MTA would fail the extended test when ARJ files were converted  that
  7393.     contained files, archived with -t1. These files can be found in  the
  7394.     original ARJxxx.EXE distribution  file (just run  a verbose list  of
  7395.     this archive,  write down  the length  of all  files, decompress the
  7396.     file, run a  DIR and compare  the lengths) and  all other ARJ  files
  7397.     that are created with the  -t1 ARJ command-line parameter. MTA  will
  7398.     now ignore the extended test when dealing with such ARJ archives;
  7399.  
  7400.   ■ In certain cases, MTA would forget to clean the temporary  directory
  7401.     when an extended test failed. This is fixed;
  7402.  
  7403.   ■ MTA will now FULLY ignore the ARJ_SW environment variable. MTA  will
  7404.     pass a  command-line parameter  to ARJ  (2.21 and  higher) that will
  7405.     force ARJ NOT  to look at  this env.var.. All  additional options in
  7406.     this env.var. must be added to the ARJCompression option;
  7407.  
  7408.   ■ MTA will still give a beep EVEN when the WarningTime option was  set
  7409.     to 0. This is fixed;
  7410.  
  7411.   ■ CarryComment would  sometimes be unable  to find the  comment in the
  7412.     FILES.BBS alike file. Fixed;
  7413.  
  7414.   ■ The full-screen picklist would 'flicker' when you pressed F1  (help)
  7415.     more than once. Fixed;
  7416.  
  7417.   ■ Sometimes MTA would screw up  the first file inside a PAK  SFX file.
  7418.     This is fixed;
  7419.  
  7420.   ■ MTA  would truncate  the log-file  when it  became bigger  than 64K.
  7421.     This is fixed;
  7422.  
  7423.   ■ MTA  would consume  8K blocks  of conventional  memory when the TICK
  7424.     support was on. This is fixed;
  7425.  
  7426.   ■ The documented  /CO command-line parameter  (to overrule the  option
  7427.     ZOOCOMPRESSION) did cause MTA to  fail. It has now been  included in
  7428.     MTA.EXE under the name /CQ;
  7429.  
  7430.   ■ MTA would sometimes not  remove directories. This happened when  MTA
  7431.     needed to access various drives. This is fixed;
  7432.  
  7433.   ■ Sometimes  MTA  would  display  a  very huge number of  uncompressed
  7434.     bytes for ARJ files (causing MTA to skip the file if that number  of
  7435.     bytes was not available on the hard-disk). This is fixed;
  7436.  
  7437.   ■ Under  4DOS (4.0  and higher),  MTA would  show a  cursor after  the
  7438.     first MOVE. This is fixed. MTA will hide the cursor after each  call
  7439.     to an external program (4DOS is one of them);
  7440.  
  7441.   ■ Various problems  with TBSCAN 2.9,  3.1 and 3.2  are fixed (look  at
  7442.     the  new  command-line  examples  for  this scanner). When using MTA
  7443.     under  DesqView  (with  SHARE),  you  MUST  use TBSCAN 3.2 or higher
  7444.     because older versions will deny the removal of files and  directory
  7445.     that MTA  (not TBSCAN!!)  has created.  The 3.2  works fine with the
  7446.     new coding in MTA  if you (at least)  use the -compat option  of the
  7447.     TBSCAN program;
  7448.  
  7449.   ■ Various problems  with HTSCAN 1.6  (and lower). Some  of them caused
  7450.     by MTA (fixed) and one of them caused by HTSCAN. When HTSCAN has  to
  7451.     run in 200Kb or less, it would cause MTA to report that the  archive
  7452.     contained a virus. The author of HTSCAN will change this bug in  the
  7453.     next version  and MTA  can now  work with  HTSCAN's new error-levels
  7454.     because of a change in the VIRUSSCANNER option;
  7455.  
  7456.   ■ Added %D macro  in the VIRUSSCANNER option.  %P (as before) will  be
  7457.     expanded to the complete  directory to scan (without  filenames), %F
  7458.     will be  expanded to  the complete  directory plus  \*.*. %D will be
  7459.     expanded to the  last branch (node)  in the temporary  directory and
  7460.     is a relative directory. This  macro can be used in  complex network
  7461.     structures;
  7462.  
  7463.   ■ Mouse  support  in  the  main  MTA-body  is  removed.  It  is  still
  7464.     available in the full-screen  pick-list. The NOMOUSE option  and the
  7465.     /NOMOUSE command-line parameter are removed from MTA;
  7466.  
  7467.   ■ Older versions of  MTA would rename the  target file if a  file with
  7468.     the same name existed  on the target location.  You can now add  the
  7469.     OVERWRITEDUPLICATES option  to force  MTA to  overwrite such  files.
  7470.     The new target-file will overwrite a file with the same name in  the
  7471.     target directory;
  7472.  
  7473.   ■ The  /CTL  command-line  parameter  is  enhanced.  You can now  also
  7474.     supply a filename (without  path) if that file  can be found in  the
  7475.     DOS  PATH,  the  current  directory  or  the directory where MTA.EXE
  7476.     (MTAOVR.EXE) is found (last option only under DOS 3.xx and higher);
  7477.  
  7478.   ■ The EXCLUDEFILE  and DONOT options  now accept wildcards,  including
  7479.     the '=' wildcard (see documentation);
  7480.  
  7481.   ■ Remote  operations (introduced  in the  14.5x versions  of MTA)  was
  7482.     only  possible  when  the  /REMOTE  command-line parameter was used.
  7483.     The REMOTE option for MTA.CTL is added;
  7484.  
  7485.   ■ MTA  will  now  do  remote  logging (modem communications) when  the
  7486.     REMOTE option or  /REMOTE command-line parameter  is set along  with
  7487.     non-zero  values  for  BAUD  and  COM-port.  If  either of these two
  7488.     contains  a  zero  (/BAUD0  and/or  /COM0),  MTA will not use remote
  7489.     logging;
  7490.  
  7491.   ■ Added  the /ANS  command-line parameter.  Normally MTA  will do  its
  7492.     remote logging in ANSI-mode. When /ANS0 is used, MTA will use  plain
  7493.     ASCII.  /ANS1  and  higher  values  (up  to  /ANS9)  will cause ANSI
  7494.     logging;
  7495.  
  7496.   ■ Added  the  NOBEEP  option.  When  WarningTime is set to a  non-zero
  7497.     value (nice  when running  unattended BUT  WITH remote  logging) you
  7498.     can still shut down the beeps and bells;
  7499.  
  7500.   ■ Added  the  /PAUSE   command-line  parameter  (no  counterpart    in
  7501.     MTA.CTL).   When present,  MTA will  halt until  you press ESC after
  7502.     EACH call to an external program. Added for debugging;
  7503.  
  7504.   ■ Added coding so  you can abort MTA  when it is waiting  for a locked
  7505.     (shared) file. If you press CTRL-E, MTA will abort from the lock;
  7506.  
  7507.   ■ Added  the NOEMS  and NOXMS  options in  MTA.CTL and  the /NOEMS and
  7508.     /NOXMS command-line parameters, to force  MTA NOT to use EMS  and/or
  7509.     XMS while swapping itself from memory;
  7510.  
  7511.   ■ Changed the logging.  The following changes have  been made:
  7512.  
  7513.     - All  records   have   been   split   into   single-item     lines,
  7514.       containing the needed info in the smallest number of bytes;
  7515.  
  7516.     - The  errors are   now recorded  in   the normal   log-file. As   a
  7517.       result  of  this change, the  ERRORLOGPATH option is  removed from
  7518.       MTA;
  7519.  
  7520.     - MTA and MTL  work with  the new log. If you convert to  15.01, you
  7521.       must run  the previous  MTL version  (with log-compression) before
  7522.       you start  using MTA  and MTL  unless   you   do   not   need  the
  7523.       statistics  inside  the log-file;
  7524.  
  7525.     - MTA  now uses  its own  codes (MTL  will also  use them):
  7526.  
  7527.       * error message
  7528.       ! important  information
  7529.       $ extra      information
  7530.       = status     information
  7531.       ~ password   information
  7532.       # conversion information  (needed by MTL)
  7533.       @ MTL        information (created by MTL)
  7534.  
  7535.   ■ Changed   the syntax   of the   xxxPATH options   (see documentation
  7536.     for  the  current  format).  This  was   done to change the swapping
  7537.     function and  to   add   alternative   archiver  versions.    PLEASE
  7538.     READ   the documentation carefully !
  7539.  
  7540.   ■ Added a cheap  alternative to archive-marking (NOMARKED  and related
  7541.     options) with the ONLYNEWFILES  option and/or the /NEW  command-line
  7542.     parameter. Only files that are newer than the file-date of the  file
  7543.     FILES.MTA in the working directory, are converted. MTA will  (re)set
  7544.     the file FILES.MTA itself;
  7545.  
  7546.   ■ At the risk  of loosing some friend,  I include the following  text.
  7547.     It  has  become  general  practice  for  some BBS's to add their own
  7548.     AV-code to ARJ and  ZIP files. In my  views the AV-code is  meant to
  7549.     tell the user  that a certain  file is untouched  after it has  been
  7550.     created by the  author. When a  BBS includes AV-codes,  it will mean
  7551.     that the file is  untouched after it has  been created by the  SYSOP
  7552.     (not the author) and that  is ALMOST useless information. It  can be
  7553.     used  as  long  as  ORIGINAL  AV-codes  are left unaltered but it is
  7554.     misleading  users  when  original  AV-codes  ARE  altered. With this
  7555.     practice, it is almost useless  to keep AV codes inside  the archive
  7556.     because you (as user/sysop) only  have the advertisement of the  BBS
  7557.     as  added  value.  To  (partially)  overcome  this  problem, MTA now
  7558.     contains an option INCLUDEAVFILES. If this option is NOT present  in
  7559.     MTA.CTL and KEEPAV is set, all AV'ed files are still unaltered.   If
  7560.     you include one or more  INCLUDEAVFILES options, and KEEPAV is  set,
  7561.     MTA will only keep the AV code for the files that match one or  more
  7562.     of  the  INCLUDEAVFILES  file-masks.  ALL  other AV'ed files will be
  7563.     converted EVEN when  KEEPAV is set.  One of the  next minor versions
  7564.     of MTA will extend this option  in a very dynamic (and more  secure)
  7565.     way;
  7566.  
  7567.   ■ Added  dynamic swapping.  In the  previous versions  you could  only
  7568.     tell to ALWAYS swap before the  call to another program was made  or
  7569.     to NEVER swap before the call  to another program was made.   Though
  7570.     this  function  was  variable  for  each  different  (de)compression
  7571.     program, it was somewhat rough. You can now supply a minimum  number
  7572.     of bytes that  must be available  in memory (conventional).  If this
  7573.     number of  bytes (or  more) is  available, MTA  will NOT swap itself
  7574.     out of  the way.  If it  isn't available,  MTA WILL  swap before the
  7575.     call  is  made.  Dynamic  swapping  is  now available in all xxxPATH
  7576.     options  (as  a  replacement  for  the  older  SWAP  value  in these
  7577.     options) and is added to the VIRUSSCANNER and all EXITxxx options;
  7578.  
  7579.   ■ Removed  the NOSWAP  option from  MTA. It  became obsolete after the
  7580.     introduction of dynamic swapping;
  7581.  
  7582.   ■ Added alternative archive-program  versions in the xxxPATH  options.
  7583.     Added the  /ALT command-line  parameter to  activate the alternative
  7584.     versions. See the chapter about the usage of alternative versions;
  7585.  
  7586.   ■ Added  support  for  SFX  (TARGET!!)  files. You can now create  SFX
  7587.     files as  the target.  To support  this option,  the values  ZIPSFX,
  7588.     ARJSFX,  LZHSFX  and  PAKSFX  can  be  used  as  the  value  for the
  7589.     COMPRESSIONTYPE  option.  Also  the  /ZIPSFX,  /ARJSFX,  /LZHSFX and
  7590.     /PAKSFX command-line parameters can now be used. Also added are  the
  7591.     ASFCOMPRESSION,  LSFCOMPRESSION  and  ZSFCOMPRESSION  options to add
  7592.     extra parameters to the  call to the archive-program  (when creating
  7593.     SFX files). The /CJS, /CLS  and /CZS command-line parameters can  be
  7594.     used  to   over-  rule   the  ASFCOMPRESSION,   LSFCOMPRESSION   and
  7595.     ZSFCOMPRESSION options.   The ZIP2EXEPATH option  is added to  point
  7596.     to the ZIP2EXE.EXE program;
  7597.  
  7598.   ■ MTA will also convert  archives inside archives (arc-in-arc) to  SFX
  7599.     files (when one of the xxxSFX  options is set) so the customer  does
  7600.     not need any decompression program to decompress the file;
  7601.  
  7602.   ■ Added support for GIFLITE.  You can now convert normal  GIF-files to
  7603.     the GIFLITE format when the  target is set to GIFLITE.  When running
  7604.     a  GIF->GIFLITE  conversion,  no  normal  archives  can (or will) be
  7605.     converted  so  'MTA  *.ZIP  /GIFLITE'  will  have  no  meaning.   To
  7606.     implement   this    function,    the   options    GIFLITEPATH    and
  7607.     GIFLITECOMPRESSION are added as well as the 'GIFLITE' value for  the
  7608.     COMPRESSIONTYPE  option.    The  /CGL   and  /GIFLITE   command-line
  7609.     parameters are also added;
  7610.  
  7611.   ■ Added support  for GIFTEST. You  can now test  GIF-files (normal and
  7612.     lite) when the target is set  to GIF. When running GIF->GIF test  no
  7613.     normal archives can (or will) be converted so 'MTA *.ZIP /GIF'  will
  7614.     have  no   meaning.  To   implement  this   function,  the   options
  7615.     GIFTESTPATH and GTECOMPRESSION are added as well as the 'GIF'  value
  7616.     for the  COMPRESSIONTYPE option.   The /CGT  and /GIF  command- line
  7617.     parameters are also added;
  7618.  
  7619.   ■ Added support for JPEG. You can now convert normal GIF-files to  the
  7620.     JPEG format  when the  target is  set to  GIF2JPG and  you can  also
  7621.     convert JPEG  (.JPG) files  back to  GIF when  the target  is set to
  7622.     JPG2GIF.  When  running  a  GIF->JPEG  or  JPEG->GIF  conversion, no
  7623.     normal archives can (or will) be converted, so 'MTA *.ARJ  /GIF2JPG'
  7624.     will have  no meaning.   To implement  these functions,  the options
  7625.     GIF2JPGPATH,  JPG2GIFPATH,  G2JCOMPRESSION  and  J2GCOMPRESSION  are
  7626.     added,  as  well  as  the   values  GIF2JPG  and  JPG2GIF  for   the
  7627.     COMPRESSIONTYPE  option.   The  /C2J,  /C2G,  /GIF2JPG  and /JPG2GIF
  7628.     command-line parameters are also added;
  7629.  
  7630.   ■ Added the MAXGIFDIM option to narrow the selection of GIF-files  for
  7631.     GIFLITE (unregistered version of GIFLITE);
  7632.  
  7633.   ■ Changed the full-screen picklist  to include the correct files  when
  7634.     one of the GIF-alike  options is used in  MTA (you will now  see the
  7635.     usable GIF/JPG files and not archives);
  7636.  
  7637.   ■ Changed the  help-display (MTA /?)  to reflect the  new command-line
  7638.     parameters in MTA 15.01;
  7639.  
  7640.   ■ Added  logic  and  support  for  the  new  PKZIP  (1.93+)  deflating
  7641.     algorithm. MTA  will detect  these files  and will  convert them  if
  7642.     the   newer    PKZIP/PKUNZIP      is    used      (ZIPVERSION    and
  7643.     PKZIPPATH/PKUNZIPPATH set  to  1.93/2.01  values)  or  will   report
  7644.     the need  for a  higher version  of PK(UN)ZIP  is you  still use the
  7645.     1.10 (or lower);
  7646.  
  7647.   ■ /UPGRADE is changed. It can  now be used to convert from  PKZIP 1.xx
  7648.     type of archives to 2.xx (it was set to convert from 0.xx to 1.xx);
  7649.  
  7650.   ■ Added support and logic for  the new ARJ (2.30+). MTA will  not con-
  7651.     vert  backup  files  in  ARJ  archives.  You can add the SKIPBACKUPS
  7652.     option in MTA.CTL  (/SBA command-line parameter)  in which case  MTA
  7653.     will  skip  ZOO  and  ARJ  archives  that contain backup-versions of
  7654.     files. Also, the  extended testing will  be skipped if  these backup
  7655.     version are available  in the archive.  With the last  change, it is
  7656.     possible to convert  ARJ files with  backups (and also  ZOO for that
  7657.     matter). For ARJ you can choose to do a normal conversion (in  which
  7658.     case  the  backup  files  are  removed)  or  you  can  use a special
  7659.     command-line parameter in the  ARJCOMPRESSION option, in which  case
  7660.     ARJ will rename all backup-versions with a special extension;
  7661.  
  7662.   ■ Added a graphical bar when parsing the MTA.CTL;
  7663.  
  7664.  
  7665.  ┌───────┬────────────────────────────┐
  7666.  │ 15.02 │ Bug & minor release        │
  7667.  └───────┴────────────────────────────┘
  7668.   ■ MTA would report 'duplicate  file, extension changed to ...'  when a
  7669.     file was  checked with  the /SIM  mode. This  could alarm users that
  7670.     saw the message at the remote side. Fixed;
  7671.  
  7672.   ■ MTA would report 'Unable  to RmDir/MkDir/ChDir to .........' when  a
  7673.     file was  checked with  the /SIM  mode. This  could alarm users that
  7674.     saw the message at the remote side. Fixed;
  7675.  
  7676.   ■ MTA would report 'SIMULATE  MODE' and not 'SIMULATE MODE  [OVERLAY]'
  7677.     on the main  screen when the  overlayed version and  /SIM were used.
  7678.     Fixed;
  7679.  
  7680.   ■ MTA would report 'DATETEST  MODE' and not 'DATETEST MODE  [OVERLAY]'
  7681.     on the main  screen when the  overlayed version and  /SIM were used.
  7682.     Fixed;
  7683.  
  7684.   ■ MTA  /? would  always cause  a GOMTA.BAT  in the  current directory,
  7685.     even when no changes were made to the note-pad;
  7686.  
  7687.   ■ The pick-list would  display ALL files when  /GIF was used. This  is
  7688.     fixed so only .GIF files are showed;
  7689.  
  7690.   ■ Some cosmetic changes in the copyrights for the remote display;
  7691.  
  7692.   ■ The overlay  algorithm is somewhat  changed to speed  up the parsing
  7693.     of the MTA.CTL alike file;
  7694.  
  7695.   ■ Added the RemoteColor option  in MTA.CTL to alter the  remote colors
  7696.     so they can match  the BBS colors. The  default colors are the  same
  7697.     as the default colors for FileDoor <tm>;
  7698.  
  7699.  
  7700.  ┌───────┬────────────────────────────┐
  7701.  │ 15.05 │ Minor Release              │
  7702.  └───────┴────────────────────────────┘
  7703.   ■ MTA would report 'no compressor available' or something alike,  when
  7704.     ZIP files were involved. This could happen when you did not  include
  7705.     a ZIP2EXEPath option in MTA.CTL and/or ZIP2EXE.EXE was not found  in
  7706.     the DOS-path. This is fixed;
  7707.  
  7708.   ■ JPG2GIF would report  'no compressor' available or  something alike,
  7709.     when JPG  files were  involved. This  could happen  when you did not
  7710.     include a GIFTESTPath option  in MTA.CTL and/or GIFTEST.EXE  was not
  7711.     found in the DOS-path. This is fixed;
  7712.  
  7713.   ■ Under  some conditions  (errors), the  'bar' would  not display  the
  7714.     correct  values,  neither  did  some  of  the  counters.  Also  when
  7715.     multiple files were  converted and one  or more files  were invalid,
  7716.     the ratio (percentage) could  show incorrect values. This  is fixed.
  7717.     MTA will now  display counters for  invalid files (in  red) also and
  7718.     the normal  counters, ratio  and 'bar'  are modified  in the correct
  7719.     way;
  7720.  
  7721.   ■ Fixed a problem  with /P (toggle logging).  This was still a  toggle
  7722.     but could result in  errors. /P can now  only be used to  switch any
  7723.     current logging to OFF. Using the log-file, must be set in MTA.CTL;
  7724.  
  7725.   ■ Added a /NVI command-line option. When used, the virus-scanning  (of
  7726.     ALL configured scanners) will be skipped;
  7727.  
  7728.   ■ Enhanced the IncludeAVFile option. You can now (optionally)  include
  7729.     the AV-number  (security env.  number) of  the filemask.  It is  now
  7730.     possible to  filter the  correct files  from the  ones that  are not
  7731.     from the  original authors.  In the  past IncludeAVFiles  PKLTE*.EXE
  7732.     would cause PKLT113.EXE to pass  (keep its AV, when KeepAV  was also
  7733.     set) even when RVH012 was the  one that added the AV-code (and  that
  7734.     is  NOT  PKWare).  Now  you  can  add  the PKW655 code to the option
  7735.     (IncludeAVFile PKLTE*.* PKW655) to force only the keeping of the  AV
  7736.     is the file matches PKLTE*.* AND the AV-code is PKW655). Also  masks
  7737.     for the AV-code (numeric/alphanumeric masks) can be used;
  7738.  
  7739.   ■ Added the AVLogPath option which causes a log-file to be  maintained
  7740.     by MTA, that included AV-numbers  and their names (like 0000  Robert
  7741.     K Jung or PKW655 PKWare Inc). This file can be maintained by MTL;
  7742.  
  7743.   ■ Added several log-records to the normal log that have to do with  AV
  7744.     (security env.)  coded. The  values will  only be  used when  either
  7745.     AVLogPath is set OR  at least one or  more AV-codes are supplied  as
  7746.     parameters for the IncludeAVPath option(s);
  7747.  
  7748.   ■ Added the test for  the MTAOVRSZ environment variable (only  overlay
  7749.     version).  If  present  and  containing  a numeric value, this value
  7750.     will be used as overlay buffer. Using number above 56000 will  cause
  7751.     MTAOVR to run faster but will also cause MTAOVR to use more  conven-
  7752.     tional memory;
  7753.  
  7754.  
  7755.  ┌───────┬────────────────────────────┐
  7756.  │ 15.06 │ Minor Release              │
  7757.  └───────┴────────────────────────────┘
  7758.   ■ Fixed a problem with a  runtime error 200 when no valid  files could
  7759.     be processed. This is fixed (both overlay and normal version);
  7760.  
  7761.   ■ Changed the DoNot  option in a way  that you can also  supply paths.
  7762.     It is now  possible to exclude  complete directories with  the DoNot
  7763.     statement  (e.g.  DoNot  E:\TUP\DONOT\*.*)  or  partial  directories
  7764.     (e.g.  DoNot  E:\TUP\SOME\DONOT\*.ARJ).  This  option  also comes in
  7765.     handy in combination with the QBBSPaths and RAPaths option(s);
  7766.  
  7767.   ■ Added a ChildTouch  option so you can  use another type of  touching
  7768.     for nested archives;
  7769.  
  7770.  
  7771.  ┌───────┬────────────────────────────┐
  7772.  │ 15.07 │ Minor Release              │
  7773.  └───────┴────────────────────────────┘
  7774.   ■ Fixed all problems with READONLY, HIDDEN and SYSTEM files. MTA would
  7775.     not copy, delete, rename  and/or  move these files. Though they will
  7776.     not show up  in  archives very frequently, some users complained. It
  7777.     was a bug and therefore fixed;
  7778.  
  7779.   ■ Added support  for  those  virusscanners  that can only work good on
  7780.     complete  drives. Scanners  like  Central  Point  Software CPAV (1.2
  7781.     and up) can  now  be  run  in batch-mode but will run best when they
  7782.     can scan a  full  drive. In  these  cases  you  should use the SUBST
  7783.     support of  MTA (only  if  you have troubles with it, you SHOULD use
  7784.     this feature, if you HAVE problems, tell me);
  7785.  
  7786.   ■ Added examples (tested  by me or others) for Dr.Solomon's virus scan
  7787.     (FINDVIRU) and  Central  Point Software's CPAV (only 1.2 and higher,
  7788.     1.0 does  not  return  errorlevels  and I skipped 1.1, so don't know
  7789.     if this version already returns errorlevels);
  7790.  
  7791.   ■ The %D macro in the VirusScanner option was not included in the DOCs
  7792.     (it is now) and there is a much better description of all the macros
  7793.     that you can use in this option (including the new %S and %L macro);
  7794.  
  7795.  
  7796.  ┌───────┬────────────────────────────┐
  7797.  │ 15.07 │ Bug (?) Release            │
  7798.  └───────┴────────────────────────────┘
  7799.   ■ Reports got in  from  users about MTA in a OS/2 2.0ß DOS box. MTA is
  7800.     not able to find any file that the  user wants to select. This nasty
  7801.     problem *looks*  like a problem with OS/2 2.0 because the normal DOS
  7802.     (ALSO IBM PC-DOS 5.0) works fine and the problems  involved  have to
  7803.     do with DOCUMENTED interrupts and NORMAL  Turbo  Pascal  processing.
  7804.     Thanks to some willin beta-testers I was able  to track the  problem
  7805.     down. This release contains a work-around that even causes MTA to be
  7806.     somewhat smaller and still giving the same functions. Under OS/2 2.0
  7807.     DOS boxes it *should* work again (as it did with beta-testers). Look
  7808.     into HELP__ME.MTA for questions about OS/2 2.0ß because  I don't run
  7809.     this operating system and must rely on the input from users who do !
  7810.  
  7811.  
  7812.  ┌───────┬────────────────────────────┐
  7813.  │ 15.10 │ Minor Release              │
  7814.  └───────┴────────────────────────────┘
  7815.  Several requests from users have  been addressed in this release.  Also
  7816.  please read the Q&A.MTA file (if it is present inside the archive).
  7817.  
  7818.   ■ Fixed another file-selection mask  (OS2 problem) in MTA.CH1. Also  a
  7819.     couple of OS2 beta-testers have  reported me that IBM has  addressed
  7820.     the problem  and that  there is  a fix-file  in the  later OS2 betas
  7821.     that can solve the problem;
  7822.  
  7823.   ■ Added the FileIDDiz option.  When active, it will store  the comment
  7824.     inside this  file into  memory. This  comment can  later be added to
  7825.     FILES.BBS (when ADDFilesBBS  is on) and/or  into the semaphore  file
  7826.     for the protocol-driver (StoreComment and /STOCOM, see later);
  7827.  
  7828.   ■ StoreSize, StoreName  (see later) and  StoreComment (see later)  can
  7829.     now also work  when remote operation  is NOT the  case. Normally you
  7830.     should  use  the  command-line  options  (/STOSIZ, /STONAM, /STOCOM)
  7831.     when you run MTA under a  door (FileDoor). When you set the  options
  7832.     in MTA.CTL  they will  work also  when remote  operation is  NOT the
  7833.     case (again,  unless you  toggle the  options to  OFF with  the same
  7834.     command-line parameters as mentioned before);
  7835.  
  7836.   ■ StoreSize  (/STOSIZ)  has  been  expanded.  You  can now supply  the
  7837.     extension of the file (normally xxxxxxxx.XS1) when the caller  needs
  7838.     to access another extension  (FileDoor 2.03 will need  the extension
  7839.     F$D);
  7840.  
  7841.   ■ Added  the StoreName  (/STONAM) option.  It will  create a file with
  7842.     old and new names that can be used by  a  protocol-driver  like  the
  7843.     FileDoor program. Only FileDoor 3.01 (and up)  will  work  with this
  7844.     semaphore file;
  7845.  
  7846.   ■ Added the StoreComment (/STOCOM) option. It will create a file  with
  7847.     comments from the header  or FILE_ID.DIZ file. It  can be used by  a
  7848.     protocol driver to overrule (supply) the comment of uploaded  files;
  7849.  
  7850.   ■ Added  SubstOn  and  SubstOff  options  to  overrule  the   internal
  7851.     sequence  that  MTA  uses  when  paging directories to a substituted
  7852.     drive;
  7853.  
  7854.   ■ The warning for using a Substituted drive is reversed. You will  now
  7855.     get a flashy warning when NOT using a substituted drive;
  7856.  
  7857.   ■ Added  the %T  macro in  all exit-calls  that can  be used to assign
  7858.     different  batch-files  for  different  tasks (when running multiple
  7859.     tasks);
  7860.  
  7861.   ■ The call to  LABEL.COM/EXE has been removed.  MTA will now use  some
  7862.     internal coding to reset the volume-label to the original label  (or
  7863.     a dummy when no label was set), when archives contain volume  labels
  7864.     inside;
  7865.  
  7866.   ■ The  CarryComment  option  did  only  allow  the first 255 bytes  of
  7867.     archive-comments to  be carried  over to  the new  archive. This has
  7868.     been enhanced to  64K of comment.  There are several  special tricks
  7869.     involved to  deal with  ARJ-comments in  this matter  because of the
  7870.     'multi-platform' 'compatible' matter  ARJ stores the  comment inside
  7871.     the  archives  (removing  part  of  the CR/LF sequence, resulting in
  7872.     problems when carried over to other archivers);
  7873.  
  7874.  
  7875.  ┌───────┬────────────────────────────┐
  7876.  │ 15.20 │ Major sub-release          │
  7877.  └───────┴────────────────────────────┘
  7878.  Several requests from users have  been addressed in this release.  Also
  7879.  take some  time to  sort out  the *.TEC  files included  (if any)  that
  7880.  cover special subjects more deeply.
  7881.  
  7882.   ■ Fixed a problem for non-registered usage where the MTA-childs  would
  7883.     all wait for a certain time (will work on most machines);
  7884.  
  7885.   ■ Fixed a problem for non-registered usage where the MTA under  remote
  7886.     operations would wait 90 seconds. This is reduced to 10 seconds;
  7887.  
  7888.   ■ MTA could be  called twice (again within  a DOS shell of  MTA). This
  7889.     is  fixed  for  most  configurations.  Only  MTA itself can call new
  7890.     copies of MTA (child processing);
  7891.  
  7892.   ■ When  displaying  message  remote  (BBS  under a door like  FileDoor
  7893.     <tm>) MTA would not restore  the color to the original  color before
  7894.     MTA was called. This is fixed;
  7895.  
  7896.   ■ When MTA  called the FOSSIL  to init remote  operations, the display
  7897.     could be trashed  if the FOSSIL  reported itself. MTA  will now save
  7898.     and restore the screen before and after the call to the  FOSSIL-init
  7899.     routine;
  7900.  
  7901.   ■ When  running under  multi-taskers (Desqview  etc.) MTA  would still
  7902.     try  to  change  the  video-mode  if  the VIDEOMODE option was used.
  7903.     This is fixed. VIDEOMODE will have no meaning under multi-tasking;
  7904.  
  7905.   ■ Fixed a problem (enhancement)  where +-comment lines were not  moved
  7906.     along with the  original file-comment in  the FILES.BBS alike  file.
  7907.     MTA will now move these +-comment lines;
  7908.  
  7909.   ■ GIF  files were  not touched  (and kept  their original  date). When
  7910.     TouchCur (also the new format,  see later), TouchHig or TouchLow  is
  7911.     the default,  GIF files  are touched  with the  current date  (or an
  7912.     added number of days, see new TouchCur format);
  7913.  
  7914.   ■ Files that were marked in  error (in the first 'TESTING' pass)  were
  7915.     not moved to the error-directory. This is fixed;
  7916.  
  7917.   ■ OverwriteDuplicates  only worked  for converted  files. It  will now
  7918.     also work  for moving  (with overwrite)  to the  error-directory and
  7919.     (if needed) the trashcan-directory;
  7920.  
  7921.   ■ Some users were reporing  problems with the child-call. As  a result
  7922.     of the rather  short command-line (110  bytes) under DOS,  MTA could
  7923.     fail with arc-in-arc files (child calls) because a longer  parameter
  7924.     was needed.  Now MTA  will pass  the command-line  parameters to the
  7925.     child-MTA thru  a file.  The file  is placed  in the  same directory
  7926.     where  MTA.EXE  (MTAOVR.EXE)  is  placed  OR  will  be placed in the
  7927.     directory that is pointed to by the TEMP environment variable;
  7928.  
  7929.   ■ Added  routines  and  coding to  work with SQZ archives. MTA already
  7930.     supports this archiver (like PKZIP 1.93a)  to  make  testing  rather
  7931.     simple. As a result of  this new archiver, the following options are
  7932.     added to MTA.CTL:
  7933.  
  7934.     - CompressionType SQZ
  7935.     - CompressionType SQZSFX
  7936.     - SQZPath
  7937.     - SQZCompression
  7938.     _ SSFCompression
  7939.  
  7940.     Also the following command-line switches are added:
  7941.  
  7942.     - /SQZ
  7943.     - /SQZSFX
  7944.     - /CS
  7945.     - /CSS
  7946.  
  7947.     They work the same as  their  counterparts for other archive programs
  7948.     like ZIP, ARJ and LZH;
  7949.  
  7950.   ■ Added MAXPATHS option with  same functions as RAPATHS and  QBBSPATHS
  7951.     but for Maxmimus <tm>;
  7952.  
  7953.   ■ Enhanced  the RAPATHS  option to  work with  RA 0.xx,  1.0x and 1.1x
  7954.     releases  of  Remote  Access  <tm>.  Also  CD-rom  areas for RA 1.1x
  7955.     releases are detected and ignored by MTA;
  7956.  
  7957.   ■ Enhanced the  QBBSPATHS option to  work with pre  2.75 releases (the
  7958.     MTA 15.10- situation) and 2.75+  releases of QuickBBS <tm>. The  pre
  7959.     2.75  format  (FLSEARCH.CTL)  remains   the  default  for   backward
  7960.     compatibility with MTA (will be altered in a later);
  7961.  
  7962.   ■ Added the  ExcludeDirectory option that  can be used  to exclude one
  7963.     or more  directories that  come from  RAPaths, QBBSPaths  and/or the
  7964.     new MAXPaths option;
  7965.  
  7966.   ■ Added  an  example  in  MTA.CTL  to  be used with the  virus-scanner
  7967.     (commercial) that is called GOBBLER <tm>;
  7968.  
  7969.   ■ Extended the usage  of the FILEIDDIZ option.  It is now possible  to
  7970.     let MTA use one of a set of files (not just only one);
  7971.  
  7972.   ■ Relaxed  the  testing  of  the  FILE_ID.DIZ alike file. In  previous
  7973.     releases  this  caused  many  warnings.  Because of the more dynamic
  7974.     usage of  comment-files (extended  FILEIDDIZ option),  MTA will  now
  7975.     store up to  20 lines with  each having up  to 128 characters,  into
  7976.     memory without giving any warnings;
  7977.  
  7978.   ■ Added command-line parameter /REMSIM  to let MTA create a  file that
  7979.     can be  TYPE'ed and  will show  the looks  of MTA  when it  displays
  7980.     messages remote. Can be used to check color-setup;
  7981.  
  7982.   ■ Added two remote lines when MTA is not used in SIMULATE mode and will
  7983.     call a child of itself. The childs (arc-in-arc files) will  not write
  7984.     remote messages (yet);
  7985.  
  7986.   ■ Added the ReplaceComment option  and the /REPLCOM toggle to  make it
  7987.     possible  to  overrule  existing  comments  in FILES.BBS alike files
  7988.     with the comment from a comment-file (like FILE_ID.DIZ);
  7989.  
  7990.   ■ Changed  /C  into /TOUCHC, /F into  /TOUCHF, /L into /TOUCHL  and /H
  7991.     into /TOUCHH for compatibility reasons;
  7992.  
  7993.   ■ Added  a new  parameter to  TouchCur (and  the /TOUCHC  command-line
  7994.     switch) to touch files with the current date PLUS a supplied  number
  7995.     of days;
  7996.  
  7997.   ■ Enhanced  the  DelOldFiles  option  so  it can work with a  relative
  7998.     number  of  days.  The  old  format  (with  a  fixed  date) is still
  7999.     possible;
  8000.  
  8001.   ■ Added VIRUSMASK option to make it possible for MTA to only call  the
  8002.     virus-scanners when matching files (extensions) are found;
  8003.  
  8004.   ■ Added ALTMTATEMPPath to make it possible for MTA to convert  smaller
  8005.     archives on a RAM-disk (or fast drive) and to swap to another  drive
  8006.     if there is not enough room on the RAM-disk (or fast drive);
  8007.  
  8008.   ■ Added WEEKEXTENSION  option to make  it possible to  convert special
  8009.     BBS-extensions (A10, J23) in a  special way (f.i. from A20  which is
  8010.     an ARC file to Z20, which is ZIP);
  8011.  
  8012.   ■ Added NOSUBSTTEST option for special environments like networks;
  8013.  
  8014.   ■ Added %NP and  %NF macros for the  SubstOn and SubstOff options.  To
  8015.     be used for networks;
  8016.  
  8017.   ■  All  toggles  (/STOSIZ,  /STOCOM  and  /STONAM excluded) can now be
  8018.     coded in two  ways. The new  format allows to  use the /command+  or
  8019.     /command- syntax to switch options on (+) or off (-);
  8020.  
  8021.   ■ Revamped the overlayed version. It will now run somewhat faster  and
  8022.     still uses  around the  same amount  of memory.  Also added  a large
  8023.     number of  envrionment variables  for the  overlay mechanism  so the
  8024.     user can change the overlay mechanism to suit her/his own needs;
  8025.  
  8026.   ■ On  general  request,  all   new,  changed  and  deleted options  in
  8027.     MTA.CTL can now  be found in  a  special  file MTA__xxx.CTL (xxx  is
  8028.     the version for which  this file is meant).  In the next releases  I
  8029.     will keep  some of  the older  MTA__xxx.CTL files,  so when you skip
  8030.     from  version  15.20  to  15.50  you  can still use all MTA__xxx.CTL
  8031.     files that were created in-between and you are still able to  update
  8032.     your own MTA.CTL in an easy way !
  8033.  
  8034.  
  8035.  ┌───────┬────────────────────────────┐
  8036.  │ 15.21 │ Bug release                │
  8037.  └───────┴────────────────────────────┘
  8038.   ■ Some  new  routines  caused a number of cosmetic bugs. These are now
  8039.     fixed (registered users!!!). Also registered users should unpack the
  8040.     supplied MTA__REG.EXE (which contains MTAREG.EXE and MTAREG.DOC) and
  8041.     run the MTAREG.EXE file once;
  8042.  
  8043.   ■ Fixed a problem in the documentation. VirusMasks was actually called
  8044.     VirusMask (in  the  DOC  and  the example MTA.CTL). This must be the
  8045.     VirusMasks option (with an extra 's' at the end);
  8046.  
  8047.   ■ Fixed a problem in the  documentation. In the FilesBBSFormat option,
  8048.     the example  showed an  incorrect  syntax for I(tem) numbers. If you
  8049.     want to select the 4th item, I4 must be used and not 4I;
  8050.  
  8051.   ■ Fixed a problem  when  a user did not use the MTATempPath option. It
  8052.     is highly  recommended that  you use this option, but if you didn't,
  8053.     MTA 15.20  would  trash  the screen  and  ignore  ALL archives. This
  8054.     problem is fixed (and you can still run MTA without the option);
  8055.  
  8056.   ■ Added coding for the new SQZ 1.08.2. 1.08.1 is still supported but
  8057.     1.08.2 files can only be converted by MTA 15.21;
  8058.  
  8059.   ■ The needed memory for SQZ is released to a normal amount, also the
  8060.     earlier problem with SQZ's temporary file is removed (fixed in the
  8061.     new SQZ release);
  8062.  
  8063.   ■ Added coding to add comments to SQZ files (CarryComment and the
  8064.     AutoDescription option). At this moment, MTA is unable to obtain
  8065.     existing comments from SQZ files;
  8066.  
  8067.   ■ Added ReportInvalidFiles option to test filesnames inside archives
  8068.     agains DOS-device names;
  8069.  
  8070.  
  8071.  ┌───────┬────────────────────────────┐
  8072.  │ 15.30 │ Major release              │
  8073.  └───────┴────────────────────────────┘
  8074.   ■ Fixed a bug where MTA 15.20 and 15.21 would  not recognize ZOO files
  8075.     in the correct way;
  8076.  
  8077.   ■ Cleaned the archive detection  for some archive types. Could  result
  8078.     in strange files (16meg) to be converted;
  8079.  
  8080.   ■ Fixed a bug in recursive ARC/HYP usage. This could result in invalid
  8081.     actions (under rare conditions);
  8082.  
  8083.   ■ Fixed a bug in extended testing. This  would  occur  when files with
  8084.     special attributes were extracted from the archive;
  8085.  
  8086.   ■ Fixed a bug where MTA 15.02 and up would go wild when files with the
  8087.     READONLY, HIDDEN and/or SYSTEM attribute were inside any archive;
  8088.  
  8089.   ■ Fixed a bug where  /ATL WAS used in the primary MTA but any child of
  8090.     MTA (arc-in-arc) would not notice the /ALT option;
  8091.  
  8092.   ■ Fixed a  bug  in the CARRYCOMMENT logic (type 2). Comments would not
  8093.     be taken from  FILES.BBS  and  would result in wrong descriptions in
  8094.     the new archive (double headers and so on);
  8095.  
  8096.   ■ Fixed a bug in the ReportInvalidFiles option. 'Device files' with an
  8097.     extension did not match  but  DOS still allows them as deviced. This
  8098.     is now fixed. The extension is stripped before the test;
  8099.  
  8100.   ■ Under rare conditions, MTA would leave the *.MTA file in the working
  8101.     directory (most noticeable with MTA /?). This is fixed;
  8102.  
  8103.   ■ Under some  multi-tasking  programs  and on some 80486 machines, MTA
  8104.     would countdown to slow or to fast. Fixed;
  8105.  
  8106.   ■ Touching of GIF files still didn't work. This is  now fixed forever;
  8107.  
  8108.   ■ The calling sequence of PKZIP would not allow the compress of any
  8109.     READONLY file. This is fixed;
  8110.  
  8111.   ■ One archive program (for the risk  of  getting  boring,  again it is
  8112.     another  'as designed'  feature  which  can not be overruled in this
  8113.     program) will  not  allow  READONLY/HIDDEN/SYSTEM files  to be moved
  8114.     into the target archive. This is fixed with a special trap;
  8115.  
  8116.   ■ The documentation (15.21 and lower) would suggest that the SHAREWAIT
  8117.     option could be used  without a  parameter. In fact it was marked as
  8118.     an error. MTA will now ignore the  SHAREWAIT parameter when there is
  8119.     no parameter coded;
  8120.  
  8121.   ■ Some  items  in the log-file (mostly errors) could not be related to
  8122.     any file. This is fixed;
  8123.  
  8124.   ■ Fixed a bug where MTA would truncate  files-counters in an incorrect
  8125.     manner. '[00]' would be stripped but '[  ]'  wouldn't where [ovrlay]
  8126.     would be stripped again (where it should stay  inside the comment);
  8127.  
  8128.   ■ Fixed a problem  where  MTA  would go crazy if you used TAB's in the
  8129.     MTA.CTL file. Only spaces  were  allowed but MTA will now also deTAB
  8130.     any TAB-character;
  8131.  
  8132.   ■ Fixed a problem  with AV'ed files where the AV bit was set but no AV
  8133.     code was present in the archive. Pervious versions of MTA would keep
  8134.     the AV code  (without  looking  at  the Include/ExcludeAVFile), this
  8135.     version will drop the AV code;
  8136.  
  8137.   ■ Fixed a problem  with ZIP files and the AUTODESCRIPTION option. This
  8138.     could result  in  help-screens and questions from the target archive
  8139.     program;
  8140.  
  8141.   ■ Enhanced the REPROTSPECIALATTRIBUTES option, so MTA can either reset
  8142.     the  attributes  to  normal (no extra parameter) or skip the archive
  8143.     (SKIP parameter coded);
  8144.  
  8145.   ■ Enhanced the VIRUSSCANNER option. There  is now a new parameter that
  8146.     must contain a short description  of the type of scanner. It will be
  8147.     displayed in the MTA log-file and  remote, when MTA is running under
  8148.     FileDoor <tm> (or  alike  programs). You  MUST CONVERT THESE OPTIONS
  8149.     IF YOU UPGRADE FROM A PREVIOUS VERSION !
  8150.  
  8151.   ■ Added  the  FIXEDCONVERSION option  to force  one or more files to a
  8152.     fixed target-system,  independent   of   the  current  target-system
  8153.     setting. Also added the /NFC  command-line  parameter to toggle this
  8154.     option off;
  8155.  
  8156.   ■ Added  the  FILESCOUNTER  option  to tell MTA which type of counters
  8157.     (if any) are used in your FILES.BBS-alike files;
  8158.  
  8159.   ■ Added the UpdateMSGFiles  option which will convert archive names in
  8160.     netmail  messages  (TICK/FES  support) much  faster (compared to the
  8161.     UpdateUntypedFiles option) when there are a large number of messages
  8162.     to be processed;
  8163.  
  8164.   ■ Added the UpdateMSGFull  and UpdateUntypedFull options. When present,
  8165.     MTA will check both  filename  AND directoryname for a match, BEFORE
  8166.     any updating is done on the untyped or MGS file;
  8167.  
  8168.   ■ Added the LeadingSpace  option  to convert comments from FILE_ID.DIZ  t,
  8169.     (and alike)  files  to a  format  that can be used by some FILES.BBS
  8170.     list-programs;
  8171.  
  8172.   ■ The virus-check programs will now be recorded in the MTA.LOG as well
  8173.     as the resulting errorlevel. You can now check WHICH virus-checker
  8174.     marked the file as infected. On the remote side, the user can that
  8175.     various virus-checkers are called;
  8176.  
  8177.   ■ Added the ExcludeAVFile option to  make the selection of archives of
  8178.     AV's must be kept more  easy. Also  bogus AV-codes can now result in
  8179.     removal of files or placement in the error-directory;
  8180.  
  8181.   ■ Added the ExcludeFriendlyMark to make it possible to skip files from
  8182.     BBS's who  use marking and already have done to the archive what you
  8183.     would normally do yourself;
  8184.  
  8185.   ■ Added  SkipNewfiles  option  to tell MTA not to touch files before a
  8186.     certain number of days have passed);
  8187.  
  8188.   ■ Added the /NUU,  /NUM,  /NUT  and  /NUF  command-line  parameters to
  8189.     toggle the  UpdateUntypedFiles,  UpdateMSGFiles,  UpdateTICKFiles or
  8190.     UpdateFESFiles to off;
  8191.  
  8192.   ■ You can  now  code  the  optional  parameter  SUB on the EXCLUDEFILE
  8193.     option to let MTA  also  delete all matched files in sub-directories
  8194.     of the archive;
  8195.  
  8196.   ■ Added the  DefFilesBBSDesc  option to change the default description
  8197.     for new files  and  files  without  any comment. Descriptions can be
  8198.     different, based on the filename;
  8199.  
  8200.   ■ Added the LogThreshold option to let MTA return an errorlevel 100 or
  8201.     116 when the log-file has grown above a certain threshold;
  8202.  
  8203.   ■ Added  the /NOOWNMARK  command-line  parameter that can be used when
  8204.     MTA is running  under  FileDoor <tm>. It  will remove any (uploaded)
  8205.     file that has your  own mark-string at the end (obvious the file was
  8206.     obtained from your BBS and will be a duplicate with a bogus name);
  8207.  
  8208.   ■ If AddFILESBBS  is  on, MTA  will  also  try to find comments in any
  8209.     DESCRIPT.ION (4Dos <tm>) comment  files  or ????????.I?? files which
  8210.     come from FileDoor <tm>;
  8211.  
  8212.   ■ Added the MakeArc  and MakeArcExclude options to convert non-archive
  8213.     files  into  archives  when  MTA is converting other archives in the
  8214.     same run. /NMA(-) and /NME(-) can  be  used  to swith either or both
  8215.     the MakeArc and MakeArcExclude option to off;
  8216.  
  8217.   ■ Added an  example  of the  calls for the virus scanner F-PROT.EXE in
  8218.     the example for MTA.CTL;
  8219.  
  8220.   ■ Added a  default  configuration file (MTA_EASY.CTL) that can be used
  8221.     as a starting point for non-BBS usage of MTA;
  8222.  
  8223.   ■ Changed the SUBST.TEC file;
  8224.  
  8225.   ■ Changed the COMMENTS.TEC file;
  8226.  
  8227.   ■ Added the ATTRIBUT.TEC file;
  8228.  
  8229.  
  8230.  ┌───────┬────────────────────────────┐
  8231.  │ 15.35 │ Minor release              │
  8232.  └───────┴────────────────────────────┘
  8233.   ■ Fixed a  big  number  of strange bugs that were caused by one of the
  8234.     included commercial PASCAL routines. These routines weren't outdated
  8235.     but did work  incorrectly. I  now  have  included routines of my own
  8236.     that work OK (after a long period of testing). Anything from hangups
  8237.     to incorrect functions could occur is some special cases. These  all
  8238.     apply to every included program;
  8239.  
  8240.   ■ Fixed some bugs in the logic where MTA would copy comments from one
  8241.     FILES.BBS to another. This should now work fine;
  8242.  
  8243.   ■ Fixed a problem where MTA would not report the  name  of the type of
  8244.     VIRUS-scan program  into  the MTA.LOG. The name you have assigned to
  8245.     a certain VIRUS-scanner  will  now  be  showed remote and inside the
  8246.     log-file;
  8247.  
  8248.   ■ Fixed a  problem  where  MTA  would detect arc-in-arc files with the
  8249.     extension being  a  valid  archive. In  these cases MTA would try to
  8250.     extract the  file (it will still do this) and would MOVE the file to
  8251.     the error-directory  (this  is  removed). These  files were thus not
  8252.     included anymore  in  the  target-archive, which  was incorrect. Any
  8253.     incorrect file  inside  a NESTED-archive (arc-in-arc) is now left as
  8254.     it was, independent of any extraction-results;
  8255.  
  8256.   ■ Fixed various problems with AV-codes (both ZIP and ARJ). You should
  8257.     consult the AVCODES.TEC file inside the MTA__TEC.EXE archive to read
  8258.     all about the problems with AV-codes;
  8259.  
  8260.   ■ Fixed a flaw where MTA would  report 'Mask file not found' where  it
  8261.     really  meant 'No files selected'. This  would  occur if you use the
  8262.     pick-list to tag files and did not tag any file at all;
  8263.  
  8264.   ■ Fixed a  problem  where  MTA would bail out after a number of files.
  8265.     This was only the case when the UPDATEMSGFILES option was active. As
  8266.     it was, MTA kept one  file-handle  open, causing the file-handles to
  8267.     exhaust. MTA would report various problems, from invalid extractions
  8268.     to invalid files;
  8269.  
  8270.   ■ Converted the MTA package  to Borland TP 7.0. Users can  apply for a
  8271.     very special version of MTA, compiled under StonyBrook Pascal, which
  8272.     can EXECUTE overlays in EMS. This version is still under development
  8273.     but if you need such a version, please send a message to me;
  8274.  
  8275.   ■ The pick-list will always scan the directory where it is started and
  8276.     in previous releases this could not be aborted. Now you can hit ESC
  8277.     when it is taking you too long;
  8278.  
  8279.   ■ Changed the  detection  code for PKZIP 2.xx AV-files. These were not
  8280.     reported  by  earlier  MTA  versions (only PKZIP 1.93 or higher with
  8281.     included AV-codes). See  the  AVCODES.TEC  file  inside MTA__TEC.EXE
  8282.     for details;
  8283.  
  8284.   ■ Changed the  detection  code  for  SQZ 1083. This version is now able
  8285.     to  generate  AV-codes  which  can  be  detected by MTA. Also the new
  8286.     SQZ1083 structures are detected and handled correctly;
  8287.  
  8288.   ■ If you  use  the /@ command-line option (to use a file with filename
  8289.     to convert), MTA will now also swap to the supplied directory. There
  8290.     is still one flaw (see /@ documentation) of minor interrest;
  8291.  
  8292.   ■ Added a new command-line parameter /DEBUG. For details, see the file
  8293.     MTADEBUG.TEC inside the MTA__TEC.EXE file, which is included  inside
  8294.     the release archive;
  8295.  
  8296.   ■ Added a new option KEEPAVNOCODE to keep AV-codes EVEN if there is no
  8297.     AV-number available or  no  AV-owner can  be extracted. This was the
  8298.     default behaviour of all  MTA  versions BEFORE 15.30. In 15.30 I did
  8299.     change it in a way  that  these  files  were always converted (as if
  8300.     there wasn't any AV-code). If you want the pre 15.30 behaviour again
  8301.     in MTA, you can include this option;
  8302.  
  8303.   ■ Added a new  option  NOCLOAKEDARCHIVES  (in combination with the new
  8304.     command-line  parameter  /NOCLOAK)  to  detect archives that contain
  8305.     an file inside with the same name as the original archive;
  8306.  
  8307.   ■ Added an extra parameter on the MTAERRORPATH option. You can set the
  8308.     parameter if you want MTA  to terminate when there are more than the
  8309.     specified number of FILES or BYTES present in the error-directory;
  8310.  
  8311.   ■ Added coding  to  use  the ORIGINAL CJPEG.EXE and DJPEG.EXE programs
  8312.     from the  Independent  JPEG Group <tm>. The  default is still to use
  8313.     the  Handmade  Software <tm> GIF2JPEG.EXE  and JPEG2GIF.EXE programs
  8314.     but  with  the  STANDARDJPEG  option  set, you  can now also use the
  8315.     original programs;
  8316.  
  8317.   ■ The options to  overrule/add  parameters  for GIF2JPEG and JPEG2GIF
  8318.     programs, are  extended  to  80 characters to accomodate the longer
  8319.     parameters needed for CJPEG.EXE and DJPEG.EXE;
  8320.  
  8321.   ■ Added the MTV program to the MTA package. MTV is a fast file-finder
  8322.     program with macro options and with detection of archives. The old
  8323.     MTV program (which was a stand-alone package) is now obsolete and
  8324.     replaced with this shape-up version;
  8325.  
  8326.  
  8327.  ┌───────┬────────────────────────────┐
  8328.  │ 15.36 │ Minor release              │
  8329.  └───────┴────────────────────────────┘
  8330.   ■ Fixed  a *POSSIBLE* problem  with  the combiination  of CARRYCOMMENT
  8331.     (2) and  commented  archives. The  problem  arises when the names of
  8332.     your  directories  are  very  long. MTA  will  now swap to a certain
  8333.     directory  to  reduce  the calling-string with at least one of these
  8334.     directories. 16.01 will deal with this problem permanently;
  8335.  
  8336.   ■ Fixed  the  problem  where  MTA would try to convert files on CD-ROM
  8337.     devices when you used RAPATHS (see later, BBSPaths);
  8338.  
  8339.   ■ Added  new  version of the archive-detection code (OPCFI) to be able
  8340.     to detect and support the new ARJ 2.39d+ archive headers;
  8341.  
  8342.   ■ Added *EXPERIMENTAL* coding  to work with the new ARJ security codes
  8343.     that  are  introduced  with ARJ 2.39d. The original ARJ239d.EXE file
  8344.     is  taken as the example for this code (no other SE-codes available,
  8345.     nor any documentation). The  old  format  (when you use ARJ 2.39c or
  8346.     lower versions) is still supported;
  8347.  
  8348.   ■ Removed  the  RAPaths,  QBBSPaths  and MAXPaths options from MTA.CTL
  8349.     (they are replaced by the BBSPaths option).
  8350.  
  8351.   ■ Added the  BBSPaths option as a replacement for the RA/QBBS/MAXPaths
  8352.     options. MTA  will  now support more BBS types and will also be able
  8353.     to detect  CD-ROM  areas in the correct way (for RA 1.1 and RA 2.0).
  8354.     Added is  the  explicit  support  for  RA 1.1x and RA 2.0x. Also the
  8355.     support  for  SBBS  (1.16) is added. Please convert your old MTA.CTL
  8356.     to the new format;
  8357.  
  8358.  
  8359.  
  8360.  MTA is tested with PKWare PKPAK version 3.61, PKWare ZIP version  1.10,
  8361.  PKWare ZIP version  2.04g, NoGate PAK  version 2.51, ARC  version 6.02,
  8362.  ZOO version 2.10,  DWC version 5.10,  LHarc version 1.13c/d/2.13,  LARC
  8363. │version 3.33, MDCD  version 1.0, ARJ version 2.39d, SQZ version 1.08.3,
  8364.  HYPER  version  25,  PKLITE  release  1.15,  GIFLITE version 2.01, JPEG
  8365.  version 1.5 (HandMade), JPEG4386 (JPEG Group) and GIFTEST version 4.0ß;
  8366.  
  8367.  
  8368.  5.4 Copyright, Trademarks
  8369.  ───────────────────────────────────────────────────────────────────────
  8370.  PKPAK, PKUNPAK, PKZIP and PKUNZIP are trademarks of PKWare Inc.
  8371.  PKLITE        is a trademark of PKWare Inc.
  8372.  SQZ           is a trademark of Jonas I Hammarberg.
  8373.  PAK           is a trademark of NoGate Consulting.
  8374.  ARC and XARC  are trademarks of SEA inc.
  8375.  ZOO           is a trademark of R. Dhesi.
  8376.  DWC           is a trademark of Dean W. Cooper
  8377.  LZH and LHarc are trademarks of Yoshi;
  8378.  LZS and LARC  are trademarks of K.Miki H.Okumura and K.Masuyama
  8379.  MD            is a trademark of Michael Davenport
  8380.  ARJ           is a trademark of Robert K. Jung
  8381.  HYPER         is a trademark of Peter Sawatzki and Klaus Peter Nischke
  8382.  CRA           is a trademark of DISP and donated to public domain
  8383.  DesqView      is a trademark of Quarterdeck inc.
  8384.  Windows       is a trademark of The Microsoft Corporation
  8385.  4Dos          is a trademark of J.P. Software / R.C. Conn and T. Rawson
  8386.  FrontDoor     is a trademark of J. Homrichhausen
  8387.  SCAN          is a trademark of McAfee Associates
  8388.  TBScan        is a trademark of Frans Veldman / ESaSS B.V.
  8389.  HTScan        is a trademark of Harry Thijssen
  8390.  VIRX          is a trademark of Microcom Software Division
  8391.  CPAV          is a trademark of Central Point Software
  8392.  FINDVIRU      is a trademark of S&S International
  8393.  Dr. Solomon   is a trademark of S&S International
  8394.  Gobbler       is a trademark of COMRAC
  8395.  F-PROT        is a trademark of Fridrik Skulason
  8396.  VALIDATE      is a trademark of McAfee Associates
  8397.  QuickBBS      is a trademark of Pegasus Software
  8398.  Remote Access is a trademark of Continental Software
  8399.  TICK          is a trademark of Berry Geller
  8400.  FES           is a trademark of Frank Ploenissen
  8401.  GIFLITE       is a trademark of Tsung Hu
  8402.  JPEG 1.5      is a trademark of Handmade Software Inc.
  8403.  JPEG          is a trademark of The Independent JPEG Group
  8404.  GIFTEST       is a trademark of Dave Navarro Jr.
  8405.  OS/2          is a trademark of International Business Machines (IBM)
  8406.  PC-DOS        is a trademark of International Business Machines (IBM)
  8407.  FileDoor      is a trademark of Robert W. van Hoeven
  8408.  
  8409.  MTA is written  in Borland Pascal 7.0, with help of the Turbo  Debugger
  8410.  3.0 and  makes extensive  use of  Object Professional  1.20 and OPCFI V
  8411. │16.15.    Some  routines   are  obtained   from  TurboPower's    Asynch
  8412.  Professional  1.10.
  8413.  
  8414.  Borland Pascal      is a trademark  of Borland International
  8415.  Turbo Debugger      is a trademark  of Borland International
  8416.  Object Professional is a trademark  of TurboPower Inc.
  8417.  Asynch Professional is a trademark  of TurboPower Inc.
  8418.  Pascal+             is a trademark  of StonyBrook software Inc.
  8419.  OPCFI               is a trademark  of Robert W. van Hoeven
  8420.  
  8421.  [======================== END OF DOCUMENT ============================]
  8422.